Deploy your Astro Site to Seenode

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.

Project Configuration

Adapter for SSR

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"
  }
}

See Seenode’s Astro deployment guide for more configuration options and troubleshooting.

How to Deploy

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

Web Interface Deployment

Create a Seenode account and sign in.
Push your code to your Git repository (GitHub or GitLab).
From the Seenode Dashboard, create a new Web Service and connect your repository.
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)
Select your preferred instance size and click Create Web Service.
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.