Astro Stack

À propos de Astro Stack

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles

Ubuntu 24.04

Application

Astro Stack

Stack technique

Node.js LTSPM2Nginx

RAM minimum

1 Go (2 Go pour SSR)

CPU minimum

1 vCPU

Accès

root par SSH

Fonctionnalités clés

• Node.js LTS depuis NodeSource — la dernière version stable, pas le paquet vieilli de la distribution.
• PM2 — redémarrage automatique, zéro coupure lors des déploiements, rotation des logs, mode cluster pour VPS multi-cœur.
• Nginx en reverse proxy avec gzip et Cache-Control longs sur les assets versionnés.
• Compatible avec la sortie statique Astro (output: 'static') et le SSR (output: 'server' + @astrojs/node).
• Empreinte mémoire minimale — un site Astro statique sous Nginx consomme moins de 50 Mo. Le SSR via PM2 ajoute environ 50 Mo par worker.
• Rendu hybride : marquez les pages avec export const prerender = true pour les prégénérer au build tout en gardant les routes dynamiques en SSR.

Quand utiliser cette solution ?

Guide

Déployer Astro Stack sur votre VPS

1. 1

   Créer le VPS

   Sélectionnez le template « Astro Stack ». 1 Go de RAM suffit pour un site statique ; 2 Go si vous prévoyez du SSR avec PM2.

2. 2

   Choisir le mode de sortie

   Dans astro.config.mjs, définissez output: 'static' pour un site entièrement prégénéré, ou output: 'server' avec adapter: node({ mode: 'standalone' }) pour du SSR. Ce choix conditionne la suite du déploiement.

3. 3

   Premier accès

   Ce template installe une chaîne d'outils (Node.js LTS, PM2, Nginx). Il n'y a pas d'interface web à ouvrir : connectez-vous en SSH et déployez votre propre projet Astro.

4. 4

   Builder et transférer

   Lancez npm run build localement ou en CI. En statique, copiez le dossier dist/ vers /var/www/astro/dist sur le VPS. En SSR, copiez dist/ et démarrez le serveur avec pm2 start dist/server/entry.mjs --name astro.

5. 5

   Configurer Nginx

   En statique : root /var/www/astro/dist; et try_files $uri $uri/ /404.html;. En SSR : proxy_pass http://localhost:4321; avec les en-têtes appropriés. Obtenez un certificat Let's Encrypt via Certbot.