Cloud platforms

Deploy the Omnigent server to a cloud platform with managed infrastructure.

Platforms

Platform	Database	Deploy method
Render	Managed Postgres	One-click deploy
Railway	Managed Postgres	Import repo from GitHub
Fly.io	SQLite on volume	`fly deploy` from CLI
Hugging Face Spaces	SQLite (ephemeral)	Docker Space

Render

One-click deploy. Render provisions the app and managed Postgres over HTTPS.

Railway

Import the repo and Railway handles the rest, including managed Postgres.

Both Render and Railway default to built-in accounts auth, so multi-user works out of the box. No admin password is auto-generated: on first boot, open the web UI and create the admin account there, or preset OMNIGENT_ACCOUNTS_INIT_ADMIN_PASSWORD in the service environment. To switch to OIDC, set the OMNIGENT_OIDC_* environment variables. See Auth & SSO for details.

Fly.io

Deploy with fly deploy using SQLite on a persistent volume. Configuration files are in deploy/fly/ in the repo.

cd deploy/fly
fly deploy

The server idles around ~275 MB RSS. Fly's default 256 MB machine will OOM-loop. The fly.toml in the repo pins a 1 GB machine. If you changed it, run fly scale memory 1024.

Hugging Face Spaces

Demo-grade Docker Space with SQLite. See deploy/hf-spaces/ in the repo.

Warning: On Hugging Face free Spaces, disk is ephemeral. Data resets on every restart. Use this for demos only.