Documentation

Download and install the desktop app on macOS or Windows, and get past Gatekeeper on an unsigned build.

What changes between Simple and Advanced mode, and how to switch later.

Where your license key comes from, and how to paste it into the desktop app.

How DeployOS updates itself in place, and how your license's update window affects which versions you can install.

Connect a VPS over SSH — DeployOS never installs a background agent.

What the one-click bootstrap installs on a fresh VPS, and how it behaves on a server that already has something running.

Import a server's running Docker Compose projects and databases as managed DeployOS apps, without redeploying anything.

Browse, edit, upload, and download files anywhere on a server's filesystem, without opening a terminal.

Back up an entire server at once, or wipe one clean — two whole-server tools distinct from per-database backups.

One-click GitHub connect via device flow, plus a personal access token fallback for self-hosted or advanced setups.

Go from a GitHub repo to a live HTTPS URL.

Dockerfile, Railpack, prebuilt image, or raw Compose — how each one builds and starts your app.

Per-app env vars, global secrets shared across apps, and pulling from an external secrets manager.

Deploy self-hosted apps like Uptime Kuma, n8n, Vaultwarden, or WordPress without touching a compose file.

Point a custom domain at your app and let DeployOS handle HTTPS automatically.

Every deploy is recorded with its commit; rolling back is usually instant, no rebuild required.

Redeploy automatically when you push to GitHub — how it works without a public webhook endpoint.

Move one app, or every project on a server, to a new machine.

Bring apps in from Coolify, Dokploy, CapRover, Dokku, raw Docker, or Render.com — a one-time move, not the same as moving between your own servers.

Schedule recurring commands on a server's crontab, with presets, logs, and one-click enable/disable.

Deploy Postgres, MySQL, MongoDB, Redis, or MSSQL on a server, and check their health.

An interactive table/collection browser and query editor for every supported database engine, with inline cell editing.

Run, schedule, download, and restore database backups — with optional offsite copies to S3.

Live CPU, RAM, and disk charts per server, and per-app health and resource usage.

Search an app's logs, run one-shot commands in its container, or open a full SSH terminal into the server.

A one-click diagnostic pass over a server or app, with a plain-English checklist.

Get pinged on deploy success/failure and metric alerts via Slack, Discord, email, or a generic webhook.

What DeployOS changes in ufw, how SSH credentials are stored, and the per-server deploy key for private repos.

Ban brute-force attackers automatically, and lock down SSH itself — without risking locking yourself out.

Free, Solo, and Pro — one-time pricing, what each tier includes, and how renewals work.

How stacking works: each extra code you redeem grows the same license instead of creating a new one.

Answers to common questions and fixes for the issues people actually run into.