Systeme
Kuglers OS
Operations Dashboard fuer Docker, Domains, Backups und Systemueberblick.
Kuglers OS
Kuglers OS ist das interne Operations Dashboard fuer das Homelab. Es buendelt Systemuebersicht, Docker-Status, Domains, Backups, Projekte und Healthchecks in einer Next.js-Anwendung.
Architektur
- Framework: Next.js App Router
- Sprache: TypeScript
- Styling: Tailwind CSS
- Datenbank: PostgreSQL
- ORM: Prisma
- Auth: Auth.js
- Deployment: Docker Compose oder Standalone-Build
- Reverse Proxy: Caddy
Produktive URL
https://os.kuglers.at
Deployment
Das Docker-Deployment laeuft als Service kuglers-os im externen Docker-Netzwerk proxy. Caddy routet intern auf:
kuglers-os:3010
Datenbank
Kuglers OS nutzt PostgreSQL. Die Datenbank darf nicht zurueckgesetzt oder geloescht werden. Zugangsdaten liegen in der .env des Projekts und werden nicht in der Dokumentation ausgegeben.
Healthcheck
Der Healthcheck liegt unter:
/api/health
Je nach Konfiguration kann ein Monitoring-Token erforderlich sein. Der Token wird nicht dokumentiert.
Wichtige Dateien im Projekt
| Datei | Zweck |
|---|---|
Dockerfile | Produktionsimage fuer Next.js Standalone |
docker-compose.yml | Docker-Service, Netzwerk und Mounts |
deploy/Caddyfile.docker | Caddy-Beispiel fuer Docker |
docs/deployment-access.md | bisherige Deployment-Notizen |
prisma/schema.prisma | Datenmodell |
Verbindung zu Kuglers Docs
Kuglers Docs ist die zentrale Betriebsdokumentation. Kuglers OS verlinkt in der Navigation auf:
https://docs.kuglers.at
Zuletzt aktualisiert: 31. Mai 2026