Deploy your Astro Site to Sevalla - Withastro

import { Steps } from '@astrojs/starlight/components';

Sevalla is an all-in-one hosting and management platform for static sites, applications, and databases.

This guide details how to deploy your Astro project to Sevalla.

Prerequisites

A Sevalla account.
Your Astro project pushed to a public or supported private Git repository (GitHub, GitLab, or Bitbucket).

Static Site Deployment

Sevalla's Static Site Hosting deploys your site directly to a global edge network.

<Steps> 1. Create a new [**Static Site**](https://docs.sevalla.com/static-sites/get-started/add-a-static-site) in the Sevalla dashboard.

Connect your Git repository (GitHub, GitLab, or Bitbucket).
Select your repository and branch (e.g., main).
Configure the build settings:
- Build command: npm run build
- Publish directory: dist
Click Create Static Site to deploy.
</Steps>

:::note Astro defaults to output: 'static', so no additional configuration is required for static deployment. :::

SSR Deployment

Sevalla's Application Hosting supports full-stack applications. You can deploy Astro projects using on-demand rendering (server-side rendering) via the Node.js adapter.

<Steps> 1. Add the [`@astrojs/node` adapter](/en/guides/integrations-guide/node/) to your Astro project.

bash

npx astro add node

Configure the adapter in astro.config.mjs. Set mode: 'standalone' and ensure host: true is set so the server listens on all addresses (required for containerized environments).

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

export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
  server: {
    host: true
  }
});

Ensure your package.json has a start script that runs the built server:
json
```
"scripts": {
  "start": "node ./dist/server/entry.mjs"
}
```
Create a new Application in the Sevalla dashboard.
Connect your Git repository.
Configure the build settings:
- Build Method: Sevalla automatically detects Node.js projects (via Nixpacks).
- Build command: npm run build
- Start command: npm run start
Click Create Application to deploy.
</Steps>

Troubleshooting

Build Failures

Check the Build Logs in the Sevalla dashboard for error messages. Ensure all dependencies are in dependencies (not devDependencies if needed at runtime).

Node Version

Ensure the Node.js version selected in Sevalla matches your local development version (check node -v).