Kick off a software project quickly.

Astro Stack

Astro Stack — Node.js LTS, PM2 and Nginx preconfigured for static or SSR Astro deployments.

1 Go (2 Go pour SSR) RAM 1 vCPU Available

Tech stack

Node.js LTSPM2Nginx
Minimum RAM1 Go (2 Go pour SSR)
Minimum CPU1 vCPU
Compatible OSChoice of Linux distributions

Astro Stack provisions your VPS with the complete toolchain an Astro project needs in production: Node.js LTS from the official NodeSource repository, PM2 for zero-downtime process management, and Nginx as the TLS-terminating reverse proxy.

Astro is unique among JavaScript frameworks: it generates a fully static site by default (zero JavaScript shipped to the browser unless you explicitly opt in), but it can also render pages server-side on demand via `@astrojs/node`. Both modes work seamlessly on this stack — static output is served directly by Nginx with no Node process running, while SSR is managed by PM2 behind an Nginx proxy.

Key features

Node.js LTS from the official NodeSource repository — the current LTS release, not the outdated distro package.
PM2 process manager — zero-downtime reloads, log rotation, startup scripts, and cluster mode for multi-core VPS.
Nginx reverse proxy with gzip compression and long-lived Cache-Control headers for versioned static assets.
Compatible with Astro static output (output: 'static') and server-side rendering (output: 'server' with @astrojs/node).
Minimal memory footprint — a static Astro site served by Nginx uses less than 50 MB. SSR via PM2 adds ~50 MB per worker.
Hybrid rendering support — mark pages with export const prerender = true to pre-render them at build time while keeping other routes dynamic.

When to use this solution?

1

Static content site

Build your Astro project with output: 'static', upload the dist/ folder, and serve it from Nginx. No Node process required at runtime — the server idles at near-zero CPU between requests.

2

SSR web application

Use the @astrojs/node adapter in standalone mode to render Astro pages on demand. PM2 supervises the Node process with automatic restart and zero-downtime reloads between deployments.

3

Frontend for an API

Serve your Astro frontend alongside API routes on the same domain. Nginx routes /api/* requests to a separate backend while delivering optimized static assets for everything else.

Deploy Astro Stack on your VPS

Guide optimized for ServOrbit Cloud VPS.

01

Create the VPS

Select the "Astro Stack" template. 1 GB RAM is sufficient for a static site; 2 GB if you need SSR with PM2.

02

Choose your output mode

In astro.config.mjs, set output: 'static' for a fully pre-rendered site, or output: 'server' with adapter: node({ mode: 'standalone' }) for SSR. This choice drives the rest of the deployment.

03

First access

This template installs a toolchain (Node.js LTS, PM2, Nginx). There is no web interface to open — connect via SSH and deploy your own Astro project.

04

Build and transfer

Run npm run build locally or in CI. For static output, copy the dist/ folder to /var/www/astro/dist on the VPS. For SSR, copy dist/ and start the server with pm2 start dist/server/entry.mjs --name astro.

05

Configure Nginx

For static: set root /var/www/astro/dist; and try_files $uri $uri/ /404.html;. For SSR: proxy_pass http://localhost:4321; with appropriate headers. Obtain a Let's Encrypt certificate with Certbot.

Frequently asked questions

Astro Stack installs Node.js LTS, PM2, and Nginx — suited for Astro projects in static (SSG) or SSR mode. Next.js Stack adds PostgreSQL for full-stack applications. Astro is often lighter because its static mode requires no Node process at runtime.

Embed the deploy button

Maintaining a project that uses Astro Stack? This button lets your readers deploy it on a VPS in one click, without reading Docker documentation.

Deploy Astro Stack on ServOrbit
Markdown
[![Deploy Astro Stack on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=astro-stack&utm_source=deploy-badge&utm_medium=referral&utm_campaign=astro-stack)
HTML
<a href="https://servorbit.com/vps-cloud?template=astro-stack&utm_source=deploy-badge&utm_medium=referral&utm_campaign=astro-stack"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Astro Stack on ServOrbit" height="40"></a>

The button points to a VPS order with the template preselected. The image is served from servorbit.com — nothing to host on your side.

Kick off a software project quickly.

Activate Astro Stack on your infrastructure.

Dedicated Cloud VPS — IPv4 included, European datacenter, support included. Your data never leaves your server.

Recommended configuration: 1 Go (2 Go pour SSR) RAM · 1 vCPU

Need help?

Browse our help center and FAQ, or reach our team — callback, WhatsApp or email. Support in French, English and Arabic.