Yuvomi

The self-hosted family planner. Private, offline-capable, and beautiful.

→ Install  ·  Website & screenshots  ·  Docs  ·  Changelog

16 modules

·

23 languages

·

0 trackers

·

AES-256 optional DB encryption

·

MIT license

Mobile PWA

_{Switch GitHub to dark mode to preview the dark theme.}

Yuvomi keeps your household organized — tasks, groceries, meals, calendar, budget, and more — in one private place, without cloud accounts or subscriptions. Runs as a Docker or Podman container on any home server or NAS, including rootless Podman on SELinux-enabled RHEL/Fedora/CentOS Stream systems. A polished, mobile-first PWA makes it feel native on every device.

Each module is independent. Use what fits, skip what doesn't.

_{Coming from Oikos? This project was renamed — nothing about the app changes.}

Yuvomi was renamed from Oikos to avoid a trademark conflict with an unrelated product. Same code, same data, same maintainer.

• Old links (github.com/ulsklyc/oikos) redirect here automatically.
• The Docker image moved to ghcr.io/ulsklyc/yuvomi; the old ghcr.io/ulsklyc/oikos keeps working — please update at your convenience.
• Existing data and settings are fully preserved on upgrade.

New home: https://yuvomi.cloud/ · Questions? Open a discussion.

_{Screenshots  ·  Modules  ·  Design  ·  Install  ·  Tech stack  ·  Docs}

---

App screenshots

Health — Vitals, meds, labs, activity & cycle tracking, per member	Rewards — Points for chores, parent-approved catalog & ledger
Split expenses — Shared costs with automatic debt simplification	Budget — Income, expenses, subscriptions, CSV export
Tasks — Kanban board, recurring schedules, multi-assignment	Calendar — Google OAuth, iCloud, CalDAV, ICS subscriptions & import
Meals — Weekly planner, recipes, one-click shopping export	Shopping — Shared lists, aisle groups, swipe gestures

_{On mobile, too — every module adapts to phone-sized screens:}
     

See all screenshots →

---

Modules

	Module	What it does
	Tasks	Deadlines, priorities, subtasks, recurring schedules, multi-member assignment, per-task visibility (only me / assignees / everyone), customizable categories, an "assigned to me" filter, and a Kanban board. Optional CalDAV import of Apple Reminders.
	Shopping	Collaborative lists grouped by aisle, with swipe gestures, per-item notes, and one-tap import from the meal plan.
	Meals	Weekly planner with multiple items per slot, weekly repeats, a drag-and-drop recipe sidebar, a one-click week randomizer, and direct export to the shopping list.
	Recipes	Create, duplicate, and scale recipes; pre-fill meal slots or save any planned meal as a recipe.
	Calendar	Google (OAuth) and CalDAV sync (iCloud, Nextcloud, Radicale), ICS subscriptions, one-time import from an .ics file or shared feed into editable local events, recurring events, attachments, holiday overlays, keyword search across title, location and notes (accent-insensitive, finds events whose date you don't know), an "assigned to me" filter, per-event visibility, a default assignee per synced calendar, assigned members shown as avatars on each event, a configurable week start (Monday, Sunday or Saturday), and a read-only webcal:// export feed that can optionally show assigned members in the event title.
	Documents	Upload, tag, preview, and organize family files with per-document visibility. Optional local folder or WebDAV storage plus Paperless-ngx and Papra (DMS) linking.
	Budget	Income, expenses, recurring entries, trend charts, a statistics tab, CSV export, accounts with starting balances and running totals plus net worth, loans, split expenses, subscription tracking with renewals and currencies, and a planning tab with per-category monthly budgets and a savings goal (planned vs. actual).
	Housekeeping	Manage household staff — schedules, check-in/out, daily or hourly billing, chores, and supply requests.
	Rewards	Point values on tasks credit assigned members; a reward catalog with parent-approved redemptions, per-member opt-in, and an auditable ledger.
	Health	Per-member vitals, medications with refill alerts, lab results, activity logs, and menstrual cycle tracking (period predictions, fertile window, cycle ring, pregnancy mode) — with trend charts, CSV export, and per-entry visibility.
	Notes & Contacts	Colored Markdown sticky notes plus a contact directory with CardDAV sync.
	Birthdays	Birthday tracker with automatic calendar events, age display, and custom reminders.
	Family	Member profiles with roles, photos, and contact details — synced to Contacts and Birthdays.
	Reminders	Task and calendar reminders via in-app badges, opt-in Web Push (HTTPS), and household Gotify/ntfy channels.
	API Tokens	Bearer / X-API-Key tokens with an OpenAPI 3.0 spec and a built-in MCP endpoint (/mcp) that lets AI agents like Claude Desktop drive the whole API in natural language. Optional per-module read/write scopes keep a token — e.g. one handed to an AI client — off sensitive areas.
	Backup	Manual and scheduled database backup/restore with pre-restore rollback. Optional WebDAV upload (Nextcloud, ownCloud, etc.).

_{Full data model and per-module details in the Spec.}

Health is not a medical device — no diagnostic claims. Health data is sensitive; enable database encryption (DB_ENCRYPTION_KEY, SQLCipher).

WebDAV document storage needs its own backup. Database backups hold document metadata and links, not the binaries on WebDAV — back up that target separately. Admin-UI WebDAV targets must resolve to public addresses; for a trusted LAN or loopback target, set DOCUMENT_STORAGE_WEBDAV_URL via the deployment environment.

---

Design & technology

• Disciplined Liquid Glass UI — readable work surfaces, subtle translucent navigation, spring animations, and module-tinted overlays — built in pure CSS, no framework
• PWA — installable on any device, works offline (read-only access to your last-seen calendar, tasks, shopping, contacts, and dashboard), and stays responsive from phone to desktop with a persistent mobile bar, configurable favorites, and tuned touch targets
• Privacy first — fully self-hosted, optional SQLCipher AES-256 database encryption (enabled in the recommended Docker setup), zero telemetry
• SSO / OpenID Connect — optional single sign-on via any OIDC provider (Authentik, Keycloak, Google, Microsoft Entra) configured with four env vars; Authorization Code + PKCE flow
• Self-service password reset — optional SMTP email lets users reset a forgotten password themselves via a time-limited emailed link; anti-enumeration by design
• Zero build step — pure ES modules, no bundler, no transpiler, no framework
• Multilingual — 23 languages with automatic locale detection (de, en, es, fr, it, sv, el, ru, tr, zh, ja, ar, hi, pt, uk, pl, nl, cs, vi, hu, ko, id, fa)

---

Install anywhere

Web installer (recommended)

A localized setup wizard — 23 languages — that runs in your browser. Auto-detects Docker or Podman, configures HTTPS, SSO, and scheduled backups, then starts the container and creates your admin account.

git clone https://github.com/ulsklyc/yuvomi.git && cd yuvomi
node tools/installer/install-server.js

Open http://localhost:8090. Requires Node.js 18+ on the host to run the installer — the app container ships its own Node 22.

Docker / Podman

Pre-built image:

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          # set SESSION_SECRET and DB_ENCRYPTION_KEY
docker compose up -d

Build from source:

git clone https://github.com/ulsklyc/yuvomi.git && cd yuvomi
cp .env.example .env
docker compose up -d --build

Open http://localhost:3000. The first visit walks you through creating your admin account.

Podman (RHEL / Fedora / CentOS Stream): Both installers auto-detect Podman and use podman-compose.yml with SELinux :Z labels. For a manual start: podman compose -f podman-compose.yml up -d. Rootless systemd autostart: tools/quadlet/oikos.container.

NAS & home servers

TrueNAS SCALE	Apps → Discover Apps → search Yuvomi → Install	No terminal required. Community Apps Catalog. Version updates via Renovate.
Umbrel	App Store → search Yuvomi → Install	One-click install. Everything stays on your Umbrel.
Unraid	Apps → search Yuvomi → Apply	Community Applications template. Set SESSION_SECRET during install.

Catalog listings are still registered under the legacy name oikos (TrueNAS oikos_community, Unraid oikos-…). The app shows and installs as Yuvomi — the technical slug is kept so existing installations (database paths and container names) upgrade seamlessly rather than breaking. Search for Yuvomi; if a store still surfaces the entry as oikos, it's the same app.

New to Docker or Podman? The Installation Guide covers engine setup, HTTPS/reverse proxy, backups, and troubleshooting step by step.

---

Tech stack

---

Documentation

Installation  ·  Spec & data model  ·  Modules  ·  Contributing  ·  Security  ·  Privacy for self-hosters  ·  Changelog  ·  Backlog

If you self-host Yuvomi in a GDPR context (EU/EEA, processing other people's data), read docs/PRIVACY-FOR-SELFHOSTERS.md before going live: it covers third-country assessments for every external service (weather, CalDAV/CardDAV, OIDC, WebDAV backup and document storage), data-processing-agreement notes, log-retention guidance, and a records-of-processing template.

---

License

MIT — see LICENSE.

_{Built with care for families who value privacy and simplicity.}