Learn Impreza Host, one path at a time.

DeploymentsImpreza documentationRead as Markdown ↗

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:

TUTORIAL 1

🤖 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.

Audience: AI-first builders · ~10 min

TUTORIAL 2

⚙️ 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.

Audience: everyone with a server · ~12 min

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.

Audience: scripts & custom integrations · ~5 min

TUTORIAL 4

🛠️ 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.

Audience: terminal & dev workflows · ~6 min

Operate and maintain your apps

ACCOUNT GUIDE

Team permissions in the browser panel

Understand service access, app management and operations reserved for the account owner.

DEPLOYMENT GUIDE

Inspect an upload and save a plan

Review source files and build options, then choose a server and deploy through the portal or MCP.

DEPLOYMENT GUIDE

Upload and reuse source versions

Publish local archives, select retained versions and rebuild through the portal or MCP.

DEPLOYMENT GUIDE

Build PHP with Composer

Review dependencies, select the public folder and deploy with Apache through the portal or MCP.

DEPLOYMENT GUIDE

Build Python with pip

Review requirements, configure a production start command and deploy through the portal or MCP.

DEPLOYMENT GUIDE

Import a Compose stack

Review services, variables and volumes, select an HTTP service and publish through the portal or MCP.

SERVER GUIDE

Order a VPS

Choose the location, operating system and size, get the exact price and order it through the REST API or MCP.

AGENT GUIDE

Update your agent

Check versions, update existing servers and confirm the heartbeat while preserving configuration and applications.

DEPLOYMENT GUIDE

Deployment safety & rollback

Understand release history, automatic recovery, manual rollback and their limits through the portal, REST API and MCP.

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

Control panels are the exception. If your server runs aaPanel / CyberPanel / CloudPanel / cPanel instead of the agent, prerequisite 2 does not apply and there is no API/CLI/MCP path. See Tutorial 2 → Control panels.

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).