@oatnil/ud-server

UnDercontrol backend server — self-hosted task & knowledge management. The package bundles the web frontend, so one command gives you the full app.

Install

npm install -g @oatnil/ud-server

Quick start

ud-server

Then open http://localhost:8080 and log in with the default personal account:

• Email: [email protected]
• Password: personal123 (change with PERSONAL_TIER_PASSWORD)

Zero-config defaults: SQLite database, data in ~/.ud-server/data, frontend served from the package, HOST_DOMAIN=http://localhost:8080.

Configuration

Everything is overridable via environment variables (or the matching CLI flags):

# Custom port (HOST_DOMAIN follows automatically for local use)
PORT=3000 ud-server

# Expose beyond localhost — HOST_DOMAIN must be the URL users reach you at
HOST_DOMAIN=https://ud.example.com ud-server

# Custom data directory
UD_DATA_PATH=/var/lib/ud-server ud-server

# PostgreSQL instead of SQLite
DATABASE_TYPE=postgres POSTGRES_HOST=localhost POSTGRES_USER=ud \
  POSTGRES_PASSWORD=secret POSTGRES_DATABASE=undercontrol ud-server

Pair it with the CLI:

npm install -g @oatnil/ud
ud login

Supported Platforms

• macOS (Intel & Apple Silicon)
• Linux (x64 & ARM64)
• Windows (x64)

Documentation

Visit oatnil.com for full documentation.