The project's README from github.com/ulsklyc/yuvomi. As one markdown file: README.md.
The self-hosted family planner.
One home instead of many subscriptions.
Tasks, calendar, budget, meals, health and more for a family, a couple or just you, on a server you own.
→ Take the tour on yuvomi.cloud · Install · Docs · Changelog · Auf Deutsch
20 modules · 27 languages · 0 trackers · 1 SQLite file · 256 MB RAM minimum
Most households glue their life together from a dozen paid apps, each with its own account, its own subscription and its own copy of your data on someone else's server. Yuvomi puts all of it in one place that belongs to you, running as a container on any home server or NAS.
| Instead of juggling… | Yuvomi gives you |
|---|---|
| a to-do & task app | Tasks - Kanban, deadlines, recurring, multi-assignment |
| a family calendar app | Calendar - sync, subscriptions, per-event visibility |
| a meal planner & recipe app | Meals & Recipes - weekly planner with shopping export |
| a grocery-list app | Shopping - shared, aisle-organized lists |
| a budgeting & cost-splitting app | Budget - income, expenses, accounts, savings goals, shared costs with debt simplification |
| a document manager | Documents - searchable family files in folders |
This is the part a folder full of separate apps cannot do:
Invited by your family? Open the invite link your admin sent you; it works for seven days. Choose a username if the invite leaves it open, and your own password (none if your household signs in with single sign-on). Then sign in and put Yuvomi on your home screen: tap Install when the app offers it, or on iPhone and iPad choose Share, then Add to Home Screen.
Switch off what your household doesn't need, and it disappears from everyone's menu. Inventory, Waste collection and Schedule start switched off.
| Module | In one line |
|---|---|
| Tasks | Kanban board with deadlines, subtasks, recurring chores, comments and a history of who ticked off what. |
| Calendar | Two-way Google and CalDAV sync, Outlook push, subscriptions, holidays and per-event visibility. |
| Rewards | Points from tasks, a parent-approved catalog, an auditable ledger and pocket money per child. |
| Notes & Contacts | Markdown sticky notes with tappable checklists, plus contacts with CardDAV sync and vCard import/export. |
| Schedule | Rotating shifts and fixed weekly timetables, shown as an overlay in the calendar. Off by default. |
| Meals | Weekly drag-and-drop planner with a recipe sidebar and direct export to the shopping list. |
| Recipes | Create and scale recipes, fill meal slots, or mirror a Mealie or Tandoor instance read-only. |
| Shopping | Shared lists sorted by aisle, with swipe gestures and an import from the meal plan. |
| Pantry | Amounts, storage locations and best-before dates, with a reminder before something expires. |
| Housekeeping | Household staff: schedules, check-in/out, billing, chores and supply requests. |
| Waste collection | Pickup schedules per waste type, even "the last Friday", or a subscribed municipal ICS calendar. Off by default. |
| Documents | Searchable family files in folders, stored locally, on WebDAV or in Google Drive. |
| Inventory | What you own, with purchase price, warranty, linked receipts, a service log and recurring deadline reminders. Off by default. |
| Health | Per-member vitals, medications, preventive care, labs, activity, cycle tracking, a fasting journal and a nutrition log, with trend charts. |
| Birthdays | Birthdays and optional name days, with calendar entries, ages and reminders. |
| Budget | Income, expenses, accounts, loans, subscriptions and shared expenses with debt simplification. |
| Family | Member profiles with roles, and invite links where new members pick their own password. |
| Reminders | For tasks, events, medications, warranties, best-before dates, expiring documents and pickups - in-app, push, Gotify, ntfy, webhook or email. |
| API Tokens | Bearer tokens with an OpenAPI 3.1 spec and a built-in MCP endpoint for AI agents. |
| Backup | Manual and scheduled backups with optional WebDAV upload and pre-restore rollback; a backup from another installation restores right in the browser. |
Every module in full detail is in the spec; building your own drop-in module - with its own dashboard widgets, permissions and translations - is covered in the module guide.
What if this project stops? Nothing changes on your machine. It is MIT-licensed and self-hosted, and there is no server of ours anywhere in the path. The container you already pulled keeps running exactly as it does today, with or without us.
What if you want your data somewhere else? Everything lives in one SQLite file on your own disk, and copying it is the whole export, as long as documents are stored in the database. Scheduled backups write a restorable archive on top of that, and the documented API pulls anything out in whatever shape you need.
How safe is access from outside? Every account can add a second factor (TOTP, with recovery codes), and an admin can require it for the whole household; new members join through an invite link and pick their own password. With single sign-on through an OIDC provider, password login can be switched off for the household, and a lost phone is signed out from any of your other devices.
What does it cost? Nothing. Yuvomi is free and MIT-licensed. You provide the server; there is no subscription, no upsell and no paid tier.
Does it phone home? On its own, it only asks GitHub whether a newer version exists, and blocking that breaks nothing. Anything else waits until you use or switch on a feature that needs it; every connection is listed in the Install section, under Requirements, network and your data.
From your NAS app store - TrueNAS SCALE, Umbrel or Unraid: search for Yuvomi in the catalog and install, no terminal.
With Docker on any server. The image ghcr.io/ulsklyc/yuvomi:latest is about 500 MB and runs
on amd64 and arm64 (Raspberry Pi 4/5); Yuvomi needs one port, 3000 by default.
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
openssl rand -hex 32 # SESSION_SECRET
openssl rand -hex 32 # DB_ENCRYPTION_KEY
Now open
.envand replace bothREPLACE_WITH_…placeholders with the two values, in that order, and write the second one down: it is the database key, and a lost or changed key never opens the database again, not by you and not by us. With a placeholder left in, Yuvomi refuses to start. To run without encryption, clear theDB_ENCRYPTION_KEYline instead of filling it.
docker compose up -d
Open http://localhost:3000 and create your admin account. Podman, Proxmox, HTTPS, backups and
troubleshooting, step by step: the install guide on yuvomi.cloud
and the installation guide.
Podman - fetch podman-compose.yml instead of docker-compose.yml and start it with
podman compose -f podman-compose.yml up -d; it carries the SELinux :Z volume labels that
RHEL, Fedora and CentOS Stream need.
Page does not load - docker compose logs (on Podman,
podman compose -f podman-compose.yml logs) usually names the reason, and the
troubleshooting guide covers the common ones.
Proxmox - the same steps run inside a small Debian LXC: see the Proxmox guide on yuvomi.cloud.
Encryption key - optional, but there is no way back. The guided setup and Umbrel generate one for you; with Compose, TrueNAS or Unraid you set it yourself, so write it down.
Guided setup - a localized setup wizard in your browser. It detects Docker or Podman, sets up single sign-on and scheduled backups, prepares Yuvomi for an HTTPS reverse proxy (the certificate stays with your proxy), 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 on the server itself; the wizard answers nowhere else. From
another device, open a tunnel first, ssh -L 8090:localhost:8090 user@server, then open the
same address there. Needs Node.js 22.14+ or 23.6+ on the host; the container ships its own
Node 24.
/data/yuvomi.db, plus the folder, WebDAV or Drive if you moved documents there.Health is not a medical device. No diagnostic claims are made. Health data is sensitive, so enable database encryption (
DB_ENCRYPTION_KEY, SQLCipher).
External document storage needs its own backup. Database backups hold document metadata and links, not binaries stored in a local folder, on WebDAV, or in Google Drive; back up the selected target separately. Yuvomi visibility settings only control access through Yuvomi. Anyone with access to the connected
Yuvomi/DocumentsGoogle Drive folder can view all files stored there.
Self-hosting in a GDPR context? If you run Yuvomi in the EU/EEA and process other people's data, read privacy for self-hosters before going live. It covers third-country assessments for every external service, data-processing-agreement notes, log-retention guidance and a records-of-processing template.
oikos in an app store? Same app, renamed.Yuvomi was renamed from Oikos to avoid a trademark conflict with an unrelated product. Same code, same data, same maintainer.
github.com/ulsklyc/oikos) redirect here automatically.ghcr.io/ulsklyc/yuvomi; the old ghcr.io/ulsklyc/oikos keeps working, so update at your convenience.oikos (e.g. Unraid oikos-…) so existing installations upgrade seamlessly. Search for Yuvomi; an entry still shown as oikos is the same app.User guide (community-maintained): @Kyrodan writes a user documentation site in his own repository. It is not part of this project and can lag behind a release, so where it and the sources above disagree, the ones above are right.
One home for your household. Yours to keep.
Install it once. No account with us, no subscription,
and nothing of ours between your household and its data.
→ Install it · Take the tour · Ask a question
One home instead of many subscriptions. Yuvomi is a self-hosted family planner: tasks, calendar, budget, meals, shopping, health and more in one PWA on your own server or NAS. Docker, Podman, TrueNAS, Umbrel, Unraid.