Skip to content

Server betreiben

Joel Klein edited this page Aug 27, 2026 · 2 revisions

Server betreiben

Das Abbild

Das Abbild baut die GitHub-Action .github/workflows/docker.yml bei jedem Versions-Tag und legt es in der GitHub-Registry ab — für linux/amd64 und linux/arm64, damit es auch auf einem Raspberry Pi läuft. :latest bekommen nur stabile Versionen, nie eine Beta.

docker pull ghcr.io/joe2824/timetracker-server:latest

Wöchentlich neu gebaut. Jeden Montag läuft derselbe Bau noch einmal — mit demselben Quelltext, aber frisch gezogenem node:22-alpine. Lücken im Unterbau werden dort geflickt, und wer :latest zieht, bekommt den Flicken, ohne dass dafür eine neue Version herausgegeben werden muss. Gebaut wird dabei immer der neueste stabile Tag, nie main: ein Sicherheitsflicken darf nicht nebenbei unveröffentlichten Quelltext ausliefern. Ändert sich das Grundabbild nicht, fällt der Lauf auf denselben Digest zurück und kostet nichts.

Von Hand geht dasselbe über Actions → Docker → Run workflow; ohne Eingabe nimmt der Lauf den neuesten stabilen Tag, mit Eingabe (z. B. v0.8.1) genau diesen.

Signiert und nachprüfbar. Jedes Abbild trägt eine Stückliste (SBOM) und seine Herkunft bei sich und ist mit cosign schlüssellos signiert:

cosign verify ghcr.io/joe2824/timetracker-server:latest \
  --certificate-identity-regexp '^https://github.com/joe2824/TimeTracker/\.github/workflows/docker\.yml@' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

gh attestation verify oci://ghcr.io/joe2824/timetracker-server:latest --repo joe2824/TimeTracker

Selbst bauen und starten geht weiterhin mit der docker-compose.yml im Wurzelverzeichnis: .env anlegen (Vorlage: server/.env.example), dann docker compose up -d --build. Den ersten Verwalter ernennt man danach im Container:

docker compose exec timetracker node admin.mjs liste
docker compose exec timetracker node admin.mjs ernenne "<Name oder Kennung>"

Umgebungsvariablen

Alle Werte kommen aus der Umgebung, nachzulesen in server/src/lib/server/config.ts.

Variable Vorgabe Bedeutung
ORIGIN http://localhost:5173 Adresse, unter der die Anwendung im Browser erreichbar ist. Muss exakt stimmen, WebAuthn prüft sie.
RP_ID Hostname aus ORIGIN Kennung, an die Passkeys gebunden sind — Hostname ohne Schema und Port. Ein Wechsel entwertet alle vorhandenen Passkeys.
RP_NAME TimeTracker Name, den der Anmeldedialog des Betriebssystems anzeigt.
ALLOWED_ORIGINS leer Herkünfte für schreibende Anfragen, durch Komma getrennt. ORIGIN hängt immer mit dran.
INVITE_CODES leer Einladungscodes, durch Komma getrennt.
REGISTRATION_OPEN false Darf sich jeder registrieren? Wahr nur bei 1, true, ja oder yes.
DATA_DIR ./data Datenordner. Im Abbild auf /data gesetzt.
DB_FILE $DATA_DIR/timetracker.db Die SQLite-Datei.
CLIENT_DIR static Wo die gebaute Oberfläche liegt. Im Abbild /app/static.
SYNC_WAIT_MS 25000 Wie lange die Warteschleife eine Anfrage offen hält.
PORT 3000 Vom adapter-node ausgewertet.
NODE_ENV — Im Abbild auf production gesetzt.

Hinter einem Reverse-Proxy zusätzlich, damit die echte Adresse des Aufrufers ankommt statt der des Proxys (alle drei wertet der adapter-node aus):

Variable Wert
ADDRESS_HEADER X-Forwarded-For
PROTOCOL_HEADER X-Forwarded-Proto
HOST_HEADER X-Forwarded-Host

Leere INVITE_CODES öffnen den Dienst nicht. Ist zusätzlich REGISTRATION_OPEN aus, kommt niemand neu hinein — das ist die Vorgabe.

Grenzen

Fest im Server, nicht einstellbar (server/src/lib/server/config.ts):

Grenze Wert
Größe eines einzelnen Chiffrats 64 KiB (ein Eintrag braucht ~400 Byte)
Datensätze je Konto 500.000 (zehn Jahre Erfassung liegen bei ~50.000)
Datensätze je Schreibvorgang 500
Datensätze je Seite beim Abholen 500, höchstens 2000
Gleichzeitige Ereignis-Verbindungen je Konto 8

Einen Server voreinstellen

DEFAULT_SERVER trägt beim Bauen eine Serveradresse fest in die Anwendung ein. Wer sie startet, muss dann nichts mehr eintippen — und findet unter der Adresse einen kleinen Link, um doch einen eigenen Server zu nehmen.

DEFAULT_SERVER=https://tracker.example.de npm run tauri build

Im Entwicklungsmodus (npm run tauri dev, npm run dev) steht ohne Zutun http://localhost:3000 drin — der Server aus der docker-compose.yml.

In der GitHub-Action kommt der Wert aus der Repository-Variable DEFAULT_SERVER (Settings → Secrets and variables → Actions → Variables). Kein Secret: die Adresse steht ohnehin in jedem Build. Ist sie nicht gesetzt, fragt die Anwendung wie bisher.

Clone this wiki locally