# Impreza Host

> Documentation for deploying and operating applications on your server through the portal, MCP, REST API and devkit.

Start with a guide for your task. Each HTML page links to a clean Markdown version. Use the remote MCP connector at https://mcp.imprezahost.com/mcp for compatible clients; use the local impreza-mcp server for local folder uploads. Authentication, scopes and service availability still apply.

## Start here

- [Documentation home](https://docs.imprezahost.com/): browse by task or search.
- [Search](https://docs.imprezahost.com/search.html): search tools, parameters, guides and errors.
- [Complete reference](https://docs.imprezahost.com/llms-full.txt): full platform reference and guides.
- [OpenAPI](https://docs.imprezahost.com/openapi.yaml): REST request and response contracts.

## Agent

- [Update your Impreza agent](https://docs.imprezahost.com/agent-updates.html): Check and update your Impreza agent while preserving its configuration and applications. Find the update command through the portal or MCP. [Markdown](https://docs.imprezahost.com/agent-updates.md).

## Deployments

- [Import a Compose stack](https://docs.imprezahost.com/compose-import.html): Import Compose image stacks, retained build contexts and runtime files through the portal, REST API and MCP. [Markdown](https://docs.imprezahost.com/compose-import.md).
- [Cancel a deployment](https://docs.imprezahost.com/deployment-cancellation.html): Cancel deployments through the portal, REST API and MCP; prepare the optional controlled build executor and understand recovery limits. [Markdown](https://docs.imprezahost.com/deployment-cancellation.md).
- [Deployment progress and interrupted agents](https://docs.imprezahost.com/deployment-progress.html): Read deployment steps and recorded history; understand agent restart and guarded host-reboot recovery. [Markdown](https://docs.imprezahost.com/deployment-progress.md).
- [Deployment safety and rollback](https://docs.imprezahost.com/deployment-safety.html): Understand deployment preparation, release history, automatic recovery and manual rollback through the Impreza portal, REST API and MCP. Includes custom Compose validation, signed webhook replay protection and MCP confirmation requirements. Covers concurrent redeploy reservation; unreleased candidate sections describe protected previews and the limited IPv4 egress baseline. [Markdown](https://docs.imprezahost.com/deployment-safety.md).
- [Inspect an upload and save a project plan](https://docs.imprezahost.com/project-plans.html): Inspect uploaded or pinned Git source and save reviewed deployments with npm workspaces, pinned package managers and build credentials. [Markdown](https://docs.imprezahost.com/project-plans.md).
- [Runtime health and deployment results](https://docs.imprezahost.com/runtime-health.html): Understand runtime health and application diagnostics, with recovery guidance and public HTTPS checks. [Markdown](https://docs.imprezahost.com/runtime-health.md).
- [Upload and reuse source versions](https://docs.imprezahost.com/source-uploads.html): Upload immutable source archives, reuse versions and redeploy through the portal, REST API and MCP. [Markdown](https://docs.imprezahost.com/source-uploads.md).
- [Learn Impreza Host, one path at a time.](https://docs.imprezahost.com/tutorials/): Step-by-step Impreza Host tutorials: deploy from an AI tool via MCP, understand the agent + apps + control panels on your VPS, call the REST API, and use the impreza CLI / devkit. [Markdown](https://docs.imprezahost.com/tutorials/index.md).
- [Deploy a private Git repository](https://docs.imprezahost.com/private-git.html): Deploy private GitHub, GitLab and SSH repositories to your Impreza server using the portal, MCP or REST API. [Markdown](https://docs.imprezahost.com/private-git.md).
- [Promote an immutable image](https://docs.imprezahost.com/image-promotions.html): Review an exact image digest from another app while preserving the destination environment. [Markdown](https://docs.imprezahost.com/image-promotions.md).
- [Organize projects and environments](https://docs.imprezahost.com/project-environments.html): Group existing applications by project, environment and component without changing their runtime. [Markdown](https://docs.imprezahost.com/project-environments.md).
- [Review a managed database connection](https://docs.imprezahost.com/service-bindings.html): Review a dedicated PostgreSQL or MariaDB connection, its credential rotation or its removal through the portal, API or MCP, with retained data, cleanup retry and mandatory startup health checks. [Markdown](https://docs.imprezahost.com/service-bindings.md).
- [Review configuration, monitor apps and recover data](https://docs.imprezahost.com/customer-workflows.html): Export application configuration, review changes, inspect metrics, configure alerts and restore PostgreSQL or MariaDB backups through the portal and MCP. [Markdown](https://docs.imprezahost.com/customer-workflows.md).
- [Protect and recover an onion service](https://docs.imprezahost.com/onion-services.html): Manage Tor access, initial protection profiles and encrypted identity export through the API, portal and MCP. [Markdown](https://docs.imprezahost.com/onion-services.md).

## Portal

- [The agent, apps & control panels on your VPS](https://docs.imprezahost.com/tutorials/agent-apps-panels.html): What actually lives inside your Impreza server: the agent daemon and what it does for you, the 1-click app catalog, custom Docker/git deploys, network modes, managed databases, and the automatically installed control panels (aaPanel, CyberPanel, CloudPanel, cPanel). [Markdown](https://docs.imprezahost.com/tutorials/agent-apps-panels.md).

## MCP

- [Connect an AI tool to Impreza Host](https://docs.imprezahost.com/tutorials/ai-mcp-integration.html): Connect Claude, Cursor, Codex CLI, VS Code / GitHub Copilot and other AI tools to Impreza Host. The fastest way is the remote connector + one-click OAuth (no install, no API key); use the local impreza-mcp server to upload folders from your computer. Two paths, prerequisites, the tools, example prompts, and troubleshooting. [Markdown](https://docs.imprezahost.com/tutorials/ai-mcp-integration.md).

## CLI & SDK

- [The impreza CLI & devkit](https://docs.imprezahost.com/tutorials/devkit-cli.html): Deploy from your terminal with the impreza CLI: one static Go binary that packages your project and ships it to your VPS. Login, deploy, manage deployments, named contexts for multiple accounts, plus the Go and Python SDKs in the devkit. [Markdown](https://docs.imprezahost.com/tutorials/devkit-cli.md).

## API

- [The REST API in 5 minutes](https://docs.imprezahost.com/tutorials/rest-api.html): The shortest path from curl to a live deployment on Impreza Host: authentication headers, the response envelope, IP whitelist, and the three calls you actually need (list servers, deploy a catalog app, deploy custom code). [Markdown](https://docs.imprezahost.com/tutorials/rest-api.md).

## Build recipes and access

- [PHP Composer: php_composer](https://docs.imprezahost.com/tutorials/agent-apps-panels.html#php-build)
- [Python pip: python_pip](https://docs.imprezahost.com/tutorials/agent-apps-panels.html#python-build)
- [Node npm: node_npm](https://docs.imprezahost.com/tutorials/agent-apps-panels.html#node-npm-build)
- [Static npm: node_npm_static](https://docs.imprezahost.com/tutorials/agent-apps-panels.html#static-npm-build)
- [Browser team permissions](https://docs.imprezahost.com/tutorials/agent-apps-panels.html#team-access)

## Additional reference

- [Platform contract reference](https://docs.imprezahost.com/reference/platform.md): detailed tool and operation semantics retained during the guide migration.
- [Extended integration reference](https://docs.imprezahost.com/reference/integrations.md): existing integration and discovery guidance.

Use impreza_search_docs inside MCP to retrieve a relevant section. Availability may differ by client version, permissions and rollout. Never infer successful execution from a queued request.