Installation
Fahrtenbuch-Server mit Docker Compose einrichten.
Voraussetzungen
- Docker und Docker Compose
- Für den Betrieb im Internet: ein Hostname und ein HTTPS-Reverse-Proxy
- Für die lokale Entwicklung: Node.js 22 oder neuer
Mit Docker Compose starten
Repository klonen und Konfiguration anlegen
git clone https://github.com/cheinisch/fahrtenbuch.git
cd fahrtenbuch
cp .env.example .env.env anpassen
Mindestens diese Werte setzen – Details unter Konfiguration:
POSTGRES_PASSWORDJWT_SECRETundTOTP_ENCRYPTION_KEY(zwei unterschiedliche, lange Zufallswerte)DEFAULT_ADMIN_USERNAME,DEFAULT_ADMIN_EMAIL,DEFAULT_ADMIN_PASSWORDPUBLIC_BASE_URL,CORS_ORIGIN,WEBAUTHN_RP_ID,WEBAUTHN_ORIGIN
Dienste starten
docker compose up -d
docker compose psDie Volumes für Datenbank, Kachel-Cache und Backups legt Compose beim ersten Start automatisch an.
Anmelden
Die Anwendung lauscht standardmäßig auf Port 3000: lokal unter http://localhost:3000, sonst unter deinem HTTPS-Hostnamen.
Sicherheit
Ändere alle Beispiel-Secrets und Admin-Zugangsdaten, bevor der Dienst aus dem Internet erreichbar ist. Nutze HTTPS und schränke den Zugriff auf Admin-Werkzeuge wie Redis Insight ein.
Datenverlust
docker compose down behält die Volumes, docker compose down -v löscht sie – inklusive Datenbank und Backups.
Lokale Entwicklung
npm ci
npm run devEine erreichbare PostgreSQL-Instanz und die Umgebungsvariablen des Backends werden weiterhin benötigt. Weitere Skripte: npm run build, npm run lint, npm test.