_{English · Deutsch}

Yuvomi

Der selbstgehostete Familienplaner. Privat, offline-fähig und schön.

→ Installieren · Website & Screenshots · Doku · Changelog

16
_Module

_·

23
_Sprachen

_·

0
_Tracker

_·

AES-256
_{optionale DB-Verschlüsselung}

_·

MIT
_Lizenz

Yuvomi-Dashboard — Aufgaben, Kalendertermine, Mahlzeiten und Einkauf auf einen Blick

_{Mobile PWA}

_{Für die dunkle Ansicht GitHub auf Dark Mode umstellen.}

Yuvomi hält deinen Haushalt organisiert — Aufgaben, Einkäufe, Mahlzeiten, Kalender, Budget und mehr — an einem privaten Ort, ohne Cloud-Konten oder Abos. Läuft als Docker- oder Podman-Container auf jedem Home-Server oder NAS, inklusive rootless Podman auf SELinux-aktivierten RHEL-/Fedora-/CentOS-Stream-Systemen. Eine ausgefeilte, mobile-first PWA lässt es sich auf jedem Gerät nativ anfühlen. Jedes Modul ist eigenständig. Nutze, was passt, lass weg, was nicht passt.

_{Kommst du von Oikos? Das Projekt wurde umbenannt — an der App ändert sich nichts.}

Yuvomi wurde von **Oikos** umbenannt, um einen Markenkonflikt mit einem unabhängigen Produkt zu vermeiden. Gleicher Code, gleiche Daten, gleicher Maintainer. - Alte Links (`github.com/ulsklyc/oikos`) leiten automatisch hierher weiter. - Das Docker-Image liegt jetzt unter `ghcr.io/ulsklyc/yuvomi`; das alte `ghcr.io/ulsklyc/oikos` funktioniert weiterhin — bitte bei Gelegenheit umstellen. - Bestehende Daten und Einstellungen bleiben beim Upgrade vollständig erhalten. Neues Zuhause: **https://yuvomi.cloud/** · Fragen? Eröffne eine [Diskussion](https://github.com/ulsklyc/yuvomi/discussions).

_{Screenshots ·
Module ·
Design ·
Installieren ·
Tech-Stack ·
Doku}

--- ## App-Screenshots

_{Aufgaben — Kanban-Board, wiederkehrende Termine, Mehrfachzuweisung}	_{Kalender — Google-OAuth, iCloud, CalDAV, ICS-Abos}
_{Budget — Einnahmen, Ausgaben, geteilte Kosten, CSV-Export}	_{Mahlzeiten — Wochenplaner, Rezepte, Ein-Klick-Einkaufsexport}
_{Einkauf — geteilte Listen, Gang-Gruppen, Wischgesten}	_{Kontakte — Familienverzeichnis, CardDAV-Sync}

Alle Screenshots ansehen →

--- ## Module | | Modul | Was es macht | |:---:|---|---| | ![tasks](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/tasks.png) | **Aufgaben** | Fristen, Prioritäten, Teilaufgaben, wiederkehrende Termine, Zuweisung an mehrere Mitglieder und ein Kanban-Board. Optionaler CalDAV-Import von Apple Erinnerungen. | | ![shopping](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/shopping.png) | **Einkauf** | Gemeinsame, nach Gang gruppierte Listen mit Wischgesten, Notizen je Artikel und Ein-Tipp-Import aus dem Mahlzeitenplan. | | ![meals](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/meals.png) | **Mahlzeiten** | Wöchentlicher Drag-and-drop-Planer mit mehreren Einträgen pro Slot, wöchentlicher Wiederholung und direktem Export in die Einkaufsliste. | | ![recipes](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/recipes.png) | **Rezepte** | Rezepte erstellen, duplizieren und skalieren; Mahlzeiten-Slots vorbefüllen oder jede geplante Mahlzeit als Rezept speichern. | | ![calendar](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/calendar.png) | **Kalender** | Google- (OAuth) und CalDAV-Sync (iCloud, Nextcloud, Radicale), ICS-Abos, wiederkehrende Termine, Anhänge, Feiertags-Overlays und ein schreibgeschützter `webcal://`-Export-Feed. | | ![documents](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/documents.png) | **Dokumente** | Familiendateien hochladen, taggen, vorschauen und organisieren, mit Sichtbarkeit je Dokument. Optionaler WebDAV-Speicher sowie Paperless-ngx- und Papra-(DMS-)Anbindung. | | ![budget](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/budget.png) | **Budget** | Einnahmen, Ausgaben, wiederkehrende Buchungen, Trend-Charts, ein Statistik-Tab, CSV-Export, Kredite, geteilte Ausgaben und Abo-Tracking mit Verlängerungen und Währungen. | | ![housekeeping](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/housekeeping.png) | **Haushaltshilfe** | Personal verwalten — Dienstpläne, Ein-/Auschecken, Tages- oder Stundenabrechnung, Aufgaben und Materialanforderungen. | | ![rewards](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/rewards.png) | **Belohnungen** | Punktwerte auf Aufgaben schreiben zugewiesenen Mitgliedern gut; ein Belohnungskatalog mit elterlich freigegebenen Einlösungen, Opt-in je Mitglied und einem prüfbaren Punktekonto. | | ![health](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/health.png) | **Gesundheit** | Vitalwerte je Mitglied, Medikamente mit Nachfüll-Warnungen, Laborwerte und Aktivitätsprotokolle — mit Trend-Charts, CSV-Export und Sichtbarkeit je Eintrag. | | ![notes](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/notes.png) | **Notizen & Kontakte** | Bunte Markdown-Notizzettel plus ein Kontaktverzeichnis mit CardDAV-Sync. | | ![birthdays](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/birthdays.png) | **Geburtstage** | Geburtstags-Tracker mit automatischen Kalenderterminen, Altersanzeige und eigenen Erinnerungen. | | ![family](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/family.png) | **Familie** | Mitgliederprofile mit Rollen, Fotos und Kontaktdaten — synchronisiert mit Kontakten und Geburtstagen. | | ![reminders](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/reminders.png) | **Erinnerungen** | Erinnerungen zu Aufgaben und Terminen per In-App-Badge, Opt-in-Web-Push (HTTPS) und Haushalts-Kanälen über Gotify/ntfy. | | ![api-tokens](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/api-tokens.png) | **API-Tokens** | Bearer-/X-API-Key-Tokens mit OpenAPI-3.0-Spec und eingebautem MCP-Endpunkt (`/mcp`) für KI-Agenten wie Claude Desktop. | | ![backup](https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docs/icons/backup.png) | **Backup** | Manuelles und geplantes Datenbank-Backup/-Restore mit automatischem Rollback vor dem Zurückspielen. Optionales WebDAV-Upload-Ziel (Nextcloud, ownCloud usw.). | _{Vollständiges Datenmodell und Modul-Details in der Spec.} > **Gesundheit ist kein Medizinprodukt** — keine diagnostischen Aussagen. Gesundheitsdaten sind sensibel; aktiviere die Datenbankverschlüsselung (`DB_ENCRYPTION_KEY`, SQLCipher). > **WebDAV-Dokumentenspeicher braucht ein eigenes Backup.** Datenbank-Backups enthalten Metadaten und Verweise auf Dokumente, nicht die Binärdateien auf WebDAV — sichere dieses Ziel separat. WebDAV-Ziele aus der Admin-Oberfläche müssen zu öffentlichen Adressen auflösen; für ein vertrauenswürdiges LAN- oder Loopback-Ziel setze `DOCUMENT_STORAGE_WEBDAV_URL` über die Deployment-Umgebung. --- ## Design & Technik - **Disziplinierte Liquid-Glass-UI** — lesbare Arbeitsflächen, dezent transluzente Navigation, Spring-Animationen und modul-getönte Overlays — in reinem CSS gebaut, ohne Framework - **PWA** — auf jedem Gerät installierbar, offline nutzbar (schreibgeschützter Zugriff auf zuletzt gesehene Kalender-, Aufgaben-, Einkaufs-, Kontakt- und Dashboard-Daten) und von Smartphone bis Desktop responsiv, mit persistenter mobiler Leiste, konfigurierbaren Favoriten und optimierten Touch-Zielen - **Datenschutz zuerst** — vollständig selbstgehostet, optionale SQLCipher-AES-256-Datenbankverschlüsselung (im empfohlenen Docker-Setup aktiv), keine Telemetrie - **SSO / OpenID Connect** — optionales Single Sign-on über jeden OIDC-Provider (Authentik, Keycloak, Google, Microsoft Entra), konfiguriert mit vier Umgebungsvariablen; Authorization-Code- + PKCE-Flow - **Self-Service-Passwort-Reset** — optionales SMTP lässt Nutzer ein vergessenes Passwort selbst per zeitlich begrenztem E-Mail-Link zurücksetzen; enumerationssicher by design - **Kein Build-Schritt** — reine ES-Module, kein Bundler, kein Transpiler, kein Framework - **Mehrsprachig** — 23 Sprachen mit automatischer Locale-Erkennung (de, en, es, fr, it, sv, el, ru, tr, zh, ja, ar, hi, pt, uk, pl, nl, cs, vi, hu, ko, id, fa) --- ## Überall installieren ### Web-Installer (empfohlen) Ein lokalisierter Setup-Assistent — 23 Sprachen — der im Browser läuft. Erkennt Docker oder Podman automatisch, konfiguriert HTTPS, SSO und geplante Backups, startet dann den Container und legt dein Admin-Konto an. ```bash git clone https://github.com/ulsklyc/yuvomi.git && cd yuvomi node tools/installer/install-server.js ``` Öffne **http://localhost:8090**. Benötigt Node.js 18+ auf dem Host für den Installer — der App-Container bringt sein eigenes Node 22 mit. ### Docker / Podman **Vorgefertigtes Image:** ```bash curl -O https://raw.githubusercontent.com/ulsklyc/yuvomi/main/docker-compose.yml curl -O https://raw.githubusercontent.com/ulsklyc/yuvomi/main/.env.example cp .env.example .env # SESSION_SECRET und DB_ENCRYPTION_KEY setzen docker compose up -d ``` **Aus dem Quellcode bauen:** ```bash git clone https://github.com/ulsklyc/yuvomi.git && cd yuvomi cp .env.example .env docker compose up -d --build ``` Öffne `http://localhost:3000`. Der erste Besuch führt dich durch die Anlage deines Admin-Kontos. > **Podman (RHEL / Fedora / CentOS Stream):** Beide Installer erkennen Podman automatisch und nutzen `podman-compose.yml` mit SELinux-`:Z`-Labels. Für einen manuellen Start: `podman compose -f podman-compose.yml up -d`. Rootless-systemd-Autostart: `tools/quadlet/oikos.container`. ### NAS & Home-Server

TrueNAS SCALE	Apps → Discover Apps → nach Yuvomi suchen → Install	Kein Terminal nötig. Community-Apps-Katalog. Versions-Updates via Renovate.
Umbrel	App Store → nach Yuvomi suchen → Install	Ein-Klick-Installation. Alles bleibt auf deinem Umbrel.
Unraid	Apps → nach Yuvomi suchen → Apply	Community-Applications-Template. `SESSION_SECRET` bei der Installation setzen.

> **Katalog-Einträge sind weiterhin unter dem alten Namen `oikos` registriert** (TrueNAS `oikos_community`, Unraid `oikos-…`). Die App zeigt und installiert sich als **Yuvomi** — der technische Slug bleibt erhalten, damit bestehende Installationen (Datenbankpfade und Containernamen) nahtlos aktualisieren statt zu brechen. Suche nach **Yuvomi**; taucht ein Store den Eintrag noch als *oikos* auf, ist es dieselbe App. > **Neu bei Docker oder Podman?** Der **[Installations-Leitfaden](docs/installation.md)** deckt Engine-Setup, HTTPS/Reverse-Proxy, Backups und Troubleshooting Schritt für Schritt ab. --- ## Tech-Stack

--- ## Dokumentation [Installation](docs/installation.md) · [Spec & Datenmodell](docs/SPEC.md) · [Module](MODULES.md) · [Mitwirken](CONTRIBUTING.md) · [Sicherheit](SECURITY.md) · [Datenschutz für Selbsthoster](docs/PRIVACY-FOR-SELFHOSTERS.md) · [Changelog](CHANGELOG.md) · [Backlog](BACKLOG.md) Wenn du Yuvomi in einem DSGVO-Kontext selbst hostest (EU/EWR, Verarbeitung fremder Daten), lies [docs/PRIVACY-FOR-SELFHOSTERS.md](docs/PRIVACY-FOR-SELFHOSTERS.md) vor dem Produktivbetrieb: Es behandelt Drittland-Bewertungen für jeden externen Dienst (Wetter, CalDAV/CardDAV, OIDC, WebDAV-Backup und Dokumentenspeicher), Hinweise zu Auftragsverarbeitungsverträgen, Empfehlungen zur Log-Aufbewahrung und eine Vorlage für das Verzeichnis von Verarbeitungstätigkeiten. --- ## Lizenz MIT — siehe [LICENSE](LICENSE).

_{Mit Sorgfalt gebaut für Familien, die Privatsphäre und Einfachheit schätzen.}