Erste Schritte
Voraussetzungen
Software, Ports und Entscheidungen, die vor der Installation vorzubereiten sind.
Empfohlene Docker-Installation
- Docker Engine und Docker Compose v2;
- Kommandozeilenzugriff mit der Berechtigung, Container zu starten;
- freier TCP-Port
2502auf dem Host oder ein anderer gewählter Host-Port; - keine persistenten Daten vorzubereiten: AstroGuide schreibt kein Anwendungs-Volume.
Entwicklung aus dem Quellcode
- Node.js
22.x; - npm 10 oder neuer mit dem Lockfile des Repositorys;
npm ci --include=optional: einige native Abhängigkeiten sind optional, für Builds aber nützlich.
Zu treffende Entscheidungen
| Frage | Empfohlene Wahl |
|---|---|
| Wie installieren? | GHCR-Image für eine Instanz; lokales Compose zur Prüfung eines Checkouts |
| Welcher Port? | standardmäßig 2502; nur den linken Host-Wert ändern |
| Fernzugriff? | lokales Netzwerk oder Reverse Proxy; AstroGuide hat keine Authentifizierung |
| Öffentliche Demo? | die offizielle URL verwenden, statt die eigene Instanz freizugeben |
Docker Compose prüfen
docker version
docker compose version