Démarrer
Prérequis
Logiciel, ports et décisions à préparer avant l'installation.
Installation Docker recommandée
- Docker Engine et Docker Compose v2 ;
- accès en ligne de commande avec le droit de lancer des conteneurs ;
- port TCP
2502libre sur l'hôte, ou un autre port hôte choisi ; - aucune donnée persistante à provisionner : AstroGuide n'écrit pas de volume applicatif.
Développement depuis les sources
- Node.js
22.12ou une version plus récente de la branche 22 ; - npm 10 ou ultérieur, avec le lockfile du dépôt ;
npm ci --include=optional: certaines dépendances natives sont optionnelles mais utiles au build.
Décisions à prendre
| Question | Choix recommandé |
|---|---|
| Comment installer ? | image GHCR pour une instance, Compose local pour valider un checkout |
| Quel port ? | 2502 par défaut ; changez uniquement la valeur hôte gauche |
| Accès distant ? | réseau local ou reverse proxy ; AstroGuide n'a pas d'authentification |
| Démo publique ? | utilisez l'URL officielle plutôt que d'exposer votre instance |
Vérifier Docker Compose
docker version
docker compose version