Seenode is a deployment platform for building and deploying web applications with databases, built-in observability, and auto-scaling. Astro sites can be deployed to Seenode using server-side rendering (SSR).

This guide includes instructions for deploying to Seenode through the web interface.

To enable on-demand rendering in your Astro project and deploy to Seenode, add the Node.js adapter with the following astro add command. This will install the adapter and make the appropriate changes to your astro.config.mjs file in one step.

npx astro add node

pnpm astro add node

yarn astro add node

After installing the adapter, update your astro.config.mjs to configure the server for Seenode’s requirements:

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';


export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
  server: {
    port: process.env.NODE_ENV === 'production' ? (Number(process.env.PORT) || 80) : 4321,
    host: true
  }
});

Update your package.json to include a start script that runs the built server:

{
  "scripts": {
    "dev": "astro dev",
    "build": "astro build",
    "preview": "astro preview",
    "start": "NODE_ENV=production node ./dist/server/entry.mjs"
  }
}

You can deploy to Seenode through the web interface by connecting your Git repository.

1. Create a Seenode account and sign in.

2. Push your code to your Git repository (GitHub or GitLab).

3. From the Seenode Dashboard, create a new Web Service and connect your repository.

4. Seenode will automatically detect your Astro project. Configure the deployment settings:

   • Build Command: npm ci && npm run build (or use pnpm / yarn equivalents)
   • Start Command: npm start
   • Port: 80 (required for web services)

5. Select your preferred instance size and click Create Web Service.

6. Your application will be built and deployed. Once complete, you’ll receive a URL to access your live Astro site after which you can link your domain.

• Seenode Cloud — Seenode dashboard
• Seenode Documentation — complete platform documentation
• Seenode Astro Guide — detailed deployment guide and troubleshooting
• Seenode Astro Template — pre-configured starter template

More Deployment Guides