Repository navigation
Server betreiben
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:latestWö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/TimeTrackerSelbst 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>"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.
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 |
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 buildIm 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.