# 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 and pick the repo in the dashboard. After that, 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

New to ox? Start with the Quickstart. Otherwise, pick the page for what you are doing now.

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

## For AI agents

Your coding agent can write and check the ox.toml for you. Press **Copy skill for AI agent** above and paste it into the agent, opened in your repo. It copies a short task and the full ox.toml rules. The agent first asks you to install the [ox CLI](https://console.t12.sorv.dev/docs/cli) and sign in, so it can also deploy, set variables and read logs. The skill alone is at [/ox-skill.md](https://console.t12.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.t12.sorv.dev/llms.txt) lists every page with a short note. [/llms-full.txt](https://console.t12.sorv.dev/llms-full.txt) has every page and guide in one Markdown file.

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