# ox docs: deploy a GitHub repo to your own Ubuntu VPS

Deploy a GitHub repo to your own Ubuntu server with ox, on systemd and Caddy, no Docker. Start with the quickstart, a framework guide or the ox.toml keys.

ox is a deployment platform: you connect a GitHub repo and ox deploys it to your own Ubuntu server with systemd and Caddy, no Docker. You run one command on the server, pick the repo in the dashboard, and every push deploys. A new release gets traffic only after its health check passes, so a failed deploy never reaches your visitors.

You push to your GitHub repo, and ox tells the agent on your server to deploy it. The agent builds the app on the server and runs it as a systemd service behind Caddy, which serves it over HTTPS. A new release goes live only after its health check passes.

## Start here

Pick the page that matches what you are doing now.

- [**Quickstart**Five steps from a fresh server to a live app.](https://console.oss-python.sorv.dev/docs/quickstart)
- [**Examples**Public repos on GitHub that ox deploys](https://console.oss-python.sorv.dev/docs/examples)
- [**Guides**A complete, checked ox.toml for a specific kind of app.](https://console.oss-python.sorv.dev/docs/guides)
- [**Config reference**Every ox.toml key, what ox detects, services, and variables.](https://console.oss-python.sorv.dev/docs/config)
- [**Troubleshooting**A failed health check, a failed build, or a domain that does not work.](https://console.oss-python.sorv.dev/docs/troubleshooting)
- [**Operate**Logs, rollbacks, backups, variables, domains, staging and previews.](https://console.oss-python.sorv.dev/docs/operate)
- [**CLI reference**Every ox command, with `--json` for scripts and agents.](https://console.oss-python.sorv.dev/docs/cli)
- [**Security**What ox locks down on your server, and how to check it.](https://console.oss-python.sorv.dev/docs/security)

## For AI agents

The **Copy skill for AI agent** button above copies the whole ox.toml authoring contract, so your coding agent can write and check the file for you. The same text is at [/ox-skill.md](https://console.oss-python.sorv.dev/ox-skill.md).

Every docs page also comes as Markdown: add `.md` to its address, or press **Copy page as Markdown**. [/llms.txt](https://console.oss-python.sorv.dev/llms.txt) lists them all with a note each, and [/llms-full.txt](https://console.oss-python.sorv.dev/llms-full.txt) is every page and guide in one Markdown file.

Last updated 2026-10-08. The page as HTML: https://console.oss-python.sorv.dev/docs