# orkestr documentation

orkestr is an EU-hosted deployment platform. Connect a repo from GitHub, GitLab, Bitbucket, or Codeberg; we detect the framework, build a Docker image, and deploy it. From there you can manage environments, run serverless functions, attach Postgres or Redis add-ons, and spin up isolated sandboxes for AI agents - all from the console, the CLI, the REST API, or an MCP client.

## Quick start

From a git repo to a live URL in two commands - `orkestr init` to create and link the project, then `orkestr deploy .` to build, ship, and print the URL. Requires an orkestr account with the repo's git provider connected. Full walkthrough in the [CLI guide](https://orkestr.eu/docs/cli).

```bash
# from inside your app's git repo
$ orkestr login          # paste an API token (once)
$ orkestr init           # detect name, repo, branch -> create the project
$ orkestr deploy .       # build, wait, and print the live URL

  Live at https://my-api.orkestr.run
```

This documentation covers four surfaces:

- **REST API** at `api.orkestr.eu` for everything you'd do in the console
- **CLI** (`orkestr`) for terminal-driven workflows and CI scripts
- **MCP server** so Claude Code, Cursor, and other MCP clients can manage your account as tool calls
- **Sandboxes API + SDKs** ([separate section](https://orkestr.eu/docs/sandboxes)) for running untrusted code in hardware-isolated VMs from any AI agent

> **New here?**
>
> Read [Getting started](https://orkestr.eu/docs/getting-started) first. It walks through a complete platform tour: connect a repo, create a project, deploy, manage environments, attach databases, configure custom domains, and roll back when something goes wrong.

## Sections

- [Getting started](https://orkestr.eu/docs/getting-started) - the platform tour, end-to-end. Connect, deploy, manage, scale.
- [Features](https://orkestr.eu/docs/features/projects) - deep dives on each part of the platform: projects, environments, deployments, functions, crons, jobs, domains, add-ons, monitoring
- [REST API reference](https://orkestr.eu/docs/api-reference) - authentication, every endpoint, request and response shapes
- [CLI reference](https://orkestr.eu/docs/cli) - install, authenticate, every command and flag
- [MCP server](https://orkestr.eu/docs/mcp) - drop-in tool calls for Claude Code, Cursor, and other MCP clients
- [Workflow examples](https://orkestr.eu/docs/workflows) - PR deploy previews, CI/CD, rollback scripts, batch ops, AI-driven flows
- [Sandboxes](https://orkestr.eu/docs/sandboxes) - EU-hosted, hardware-isolated VMs for AI agents (Python + JS SDKs, REST, MCP)

## Resources

- [Pricing](https://orkestr.eu/pricing) - plans, limits, and overage rates
- [Integrations](https://orkestr.eu/integrations) - GitHub, GitLab, Bitbucket, Codeberg, MCP clients
- [Security](https://orkestr.eu/security) - container hardening, network isolation, sub-processors
- [Blog](https://blog.orkestr.eu) - engineering posts and release notes