Learn Impreza Host, one path at a time.
Hands-on, human-friendly guides for every way to ship to your own server. Start with the AI path if you live in Claude Code / Cursor / Codex, or jump straight to the REST API and CLI if you prefer terminals and scripts. Each guide is self-contained and tells you exactly which prerequisites it assumes.
Pick where you want to start:
🤖 Connect an AI tool (MCP)
Two ways: add a remote connector + one-click OAuth (no install, no key), or install impreza-mcp in Claude Code / Cursor / Codex to deploy by just chatting.
⚙️ The agent, apps & control panels
What actually runs inside your VPS: the agent, the app catalog, custom deploys, network modes, and the auto-installed control panels.
TUTORIAL 3🔌 REST API in 5 minutes
The shortest path from curl to a live deployment: auth headers, the envelope, and the three calls you actually need.
🛠️ The impreza CLI & devkit
One static Go binary that packages your project and ships it. Login, deploy, manage, and use named contexts for multiple accounts.
The three prerequisites (every path shares them) #
No matter which guide you follow, the platform needs the same three things to exist on your
account before any deploy works. If a call returns "no servers on your account" or
403 IP_NOT_WHITELISTED, it is always one of these:
| # | Prerequisite | Where to set it up |
|---|---|---|
| 1 | A server (Impreza VPS / dedicated, or BYO) | Shows up under My Apps |
| 2 | The agent running on it (status: online) | My Apps → + Add another server |
| 3 | An API key (IP whitelist optional — or pair / use OAuth) | Portal → Impreza API |
For AI assistants #
These tutorials are written for humans. If you are an AI assistant reading this, the structured,
paste-into-context briefings live at
/llms.txt (index) and
/llms-full.txt (full platform dump).