Yuvomi

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. Out of the box, only a version check leaves it.

→ Take the tour on yuvomi.cloud  ·  Install in minutes  ·  Docs  ·  Changelog

_{Auf Deutsch lesen}

_{20 modules  ·  26 languages  ·  0 trackers  ·  optional AES‑256 database encryption}

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.

This is the part a folder full of separate apps cannot do:

• One import turns the week's meal plan into a shopping list. The next seven days come pre-selected, and every ingredient lands on the shared list, sorted by aisle.
• The last jar out of the pantry goes on the list with one tap. After the shop, one button books what you ticked off back into the pantry, with amount and unit.
• A ticked-off chore pays out. Points on a task go to whoever did it - the assignee, or the person picked when it is ticked off - and are spent in a reward catalog you control.
• A filed receipt hangs on the booking. Upload it once and it belongs to the transaction, the shared expense and the inventory item at the same time.

• The tablet on the kitchen wall shows today's plan and who is up in wall mode, readable across the room. It has an account of its own: tap a task, pick who did it, and the points go to them. When it sits idle, an Immich screensaver can show your own photos.
• The app on every phone goes on the home screen straight from the browser, no app store. Reminders arrive as push notifications even while it is closed (your server needs HTTPS for that), and the last shopping list you opened stays readable without signal.
• Every member joins by invite link and picks their own password; a child without a phone gets an account created directly. Per family role, each module is full, read only or not at all.

More on yuvomi.cloud

Switch off what your household doesn't need, and it disappears from everyone's menu. Inventory, Waste collection and Schedule start switched off.

• Plan - Tasks · Calendar · Schedule · Notes
• Household - Meals · Recipes · Shopping · Pantry · Housekeeping · Waste collection · Documents · Inventory · Rewards
• People - Health · Contacts · Birthdays
• Finance - Budget
• Settings - Family · Reminders · API Tokens · Backup

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.

Pick your way in: Docker or Podman for full control, the guided setup wizard in your browser, or your NAS app store without a terminal.

• Image - ghcr.io/ulsklyc/yuvomi:latest, about 500 MB, for amd64 and arm64 (Raspberry Pi 4/5).
• Needs - 256 MB RAM and one port, 3000 by default.
• Encryption key - optional, but there is no way back: a lost or changed key never opens the database again, not by you and not by us. The guided setup and Umbrel generate one for you; with Compose, TrueNAS or Unraid you set it yourself, so write it down.

On 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.

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 .env and replace both REPLACE_WITH_… placeholders with the two values you just generated, in that order, and write the second one down: it is the database key, and nothing can recover it. With a placeholder left in, Yuvomi refuses to start. To run without encryption, clear the DB_ENCRYPTION_KEY line instead of filling it.

docker compose up -d

Open http://localhost:3000. The first visit walks you through creating your admin account. If the 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.

On Proxmox, the same steps run inside a small Debian LXC: see the Proxmox guide on yuvomi.cloud.

A setup wizard in your browser, in 26 languages. 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+ on the host; the container ships its own Node 24.

TrueNAS SCALE, Umbrel and Unraid all carry Yuvomi: search for it in the app catalog and install, no terminal required. New to containers? The installation guide covers engine setup, HTTPS, backups and troubleshooting step by step.

• No build step - pure ES modules and plain CSS. No bundler, no transpiler, no framework, no runtime CDN.
• Apple HIG in the Liquid Glass language - the system font stack and Apple's type scale, capsule controls, inset-grouped lists and spring motion, verified for WCAG AA in light and dark.
• Privacy first - fully self-hosted, optional SQLCipher AES-256 database encryption, zero telemetry.
• Sign-in for a whole household - two-factor authentication, invite links, optional password reset by email and single sign-on with any OIDC provider; see how safe access from outside is.
• 26 languages with automatic detection. A separate household setting decides the language of entries Yuvomi creates itself, so an exported calendar speaks your household's language instead of English.

• See it - Tour and screenshots on yuvomi.cloud  ·  Install guide on yuvomi.cloud
• Run it - Installation  ·  Security  ·  Privacy for self-hosters  ·  Notification webhooks  ·  Immich screensaver
• Build on it - Spec & data model  ·  Third-party modules  ·  Contributing
• Follow the project - Changelog  ·  Roadmap  ·  Decisions  ·  Scope  ·  Backlog  ·  Releasing

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 in minutes  ·  Take the tour  ·  Ask a question

_{MIT licensed, see LICENSE. More at yuvomi.cloud.}