Documentation

How it works, in detail.

The long-form version: architecture, technical details, and step-by-step guides. For quick answers, try the FAQ; for anything unanswered, ask us.

Guides

Quickstart: first deploy in ten minutes From a new account to a live HTTPS URL — connect GitHub, pick a repo, watch the build, and push your first update. Deploy from Claude: connect the Candor MCP Connect Claude to Candor Deploy so you can say 'deploy this to Candor' and it happens — sign in once from Claude Code, claude.ai, Claude Desktop or ChatGPT; no token to copy. Deploy from Codex: connect the Candor MCP Connect OpenAI Codex to Candor Deploy so you can say 'deploy this to Candor' from the Codex CLI or IDE extension — sign in once, no token to copy. Deploy from OpenCode: connect the Candor MCP Connect OpenCode to Candor Deploy so you can say 'deploy this to Candor' from the terminal — one config block and a sign-in, no token to copy. Deploy from Pi: connect the Candor MCP Connect the Pi coding agent to Candor Deploy so you can say 'deploy this to Candor' — install the MCP adapter, add one server, sign in. Builds and configuration: detection, monorepos, ports What happens between git push and a live URL — how Candor Deploy detects your stack, builds with Nixpacks, and handles monorepos, ports and env vars. The .candorfile: telling us how to run your app The optional file you commit beside your code to set build directory, port, builder, start command, databases and environment — and what it overrides. Databases on Candor Deploy Managed Postgres, MySQL, and Redis for your deployed apps — how to create one, connect it, and what the real limits are. Domains and HTTPS on Candor Deploy How your app gets its built-in candorhost.app URL, how to attach your own domain, the exact DNS records to set, and how HTTPS certificates issue automatically. Troubleshooting deploys: builds, crashes, and logs Where build and runtime logs live, what each deploy phase means, and how to fix the failures we see most — build errors, wrong ports, missing env vars.