Ontoplano：桌面与移动端生活管理中枢（非 Google 出品）

Summary

Ontoplano is a central hub for organizing your life. Powerful enough to handle small details, simple enough to be able to add a task or a note in your phone with one finger movement. You can Connect with an AI agent (or not), and scope all your tasks, recipes, inventory, notes, bills etc. in specific notebooks.

I am creating tutorials for Ontoplano in YouTube. Check them out or request one in the comments.

This software was publicly released on September 5th, 2026. It's still maturing, and it may contain bugs. LLMs are used during development; their output is reviewed and tested before it lands.

Help improve it by creating issues and pull requests.

Running it

A local instance keeps its settings in ~/.config/ontoplano/ and its database in ~/.local/share/ontoplano/.

git clone https://github.com/ontoplano/ontoplano && \
cd ontoplano && \
yarn && \
yarn dev             # dev server at http://localhost:1493

Optionally:

make db-seed    # synthetic data for the dev account

Systemd

make install-service

Docker

docker run -d --name ontoplano -p 1493:1493 \
  -v ontoplano-data:/data \
  -e ORIGIN=http://localhost:1493 \
  -e BETTER_AUTH_SECRET="$(openssl rand -base64 32)" \
  ontoplano/ontoplano:latest

Register at /login — the first account owns the instance, and after it registration is closed until changed at /settings/instance.

The reminders timer comes installed.

Binaries

# Debian, Ubuntu, Mint, Pop!_OS
sudo apt install ./ontoplano_*_amd64.deb

# Fedora, RHEL, openSUSE
sudo dnf install ./ontoplano-*.x86_64.rpm

# Arch, Manjaro (not on the AUR yet)
mkdir ontoplano && cd ontoplano
curl -LO https://github.com/ontoplano/ontoplano/releases/latest/download/PKGBUILD
curl -LO https://github.com/ontoplano/ontoplano/releases/latest/download/ontoplano.install
makepkg -si

then sudo ontoplano config to set the origin and sudo systemctl enable --now ontoplano. The .deb and the .rpm are on the releases page; they carry their own Node, so there is nothing else to install. A packaged install keeps its settings in /etc/ontoplano/ and its database in /var/lib/ontoplano/. There is no Windows installer yet — help build one.

On Windows

In PowerShell, once:

wsl --install -d Ubuntu

Reboot if it asks, then open Ubuntu from the Start menu and run everything there:

sudo apt update && sudo apt install -y nodejs npm git
sudo npm install -g yarn
git clone https://github.com/ontoplano/ontoplano.git && cd ontoplano
yarn
yarn dev

Then open http://localhost:1493 in Windows — WSL forwards the port, so the browser is the one you already use.

There is no systemd on this path, and that is the whole difference: nothing starts on boot, make dev and the ontoplano service commands do not apply, and yarn dev holds the terminal for as long as you want the app up. Close the terminal and the app stops. Everything else — the data, the settings, the upgrades — works the way it does anywhere else, under your Linux home inside WSL (\\wsl$\Ubuntu\home\<you> from Explorer).

See CONTRIBUTING.md for details on helping with the code.

Deploying it

The same from-source install, kept running as a service:

# ~/.config/ontoplano/env
ORIGIN=https://ontoplano.example.com   # must be the public origin, or CSRF rejects every form
BETTER_AUTH_SECRET=…                   # openssl rand -base64 32

make install-service        # build, migrate, install the service + reminders
make deploy-local           # after changes: rebuild, redeploy, restart
make install-mail-service   # the weekly mail, if you run SMTP

Keep it on 127.0.0.1 behind a reverse proxy that terminates TLS, and point something at /healthz. docs/reference/configuration.md is the full list of settings, docs/BACKUP.md covers backups, docs/ANDROID.md the phone.

Signing in is an address and a password. Email is optional — without SMTP settings, confirmation and reset links are written to the server log instead of sent.