Private deployment documentation
For delivery and implementation: install Rhea / Themis / Tethys / Theia in the customer's own Kubernetes cluster, plus operations after installation.
The entry point for delivery and implementation: find the chapter for your task.
Navigation
| What you want to do | Which document to read |
|---|---|
| Assess whether it can be installed and what you need to prepare | Deployment overview |
| Build a POC cluster from a bare host | Cluster setup (MicroK8s) → Install Istio → Configure PostgreSQL → Edge nginx → Cloudflare in front |
| The host is on a mainland China network and images or installers will not download | Mainland China network — conditional, sits right after cluster setup; skip it when the host can reach overseas registries |
| First installation, get it running as fast as possible | One-click deployment (Bundle) |
| You would rather install from a UI than write YAML | Bootstrap with a local tethys — run the three tethys services locally, install the operator and import the Bundle in the UI |
| Audit / customize, or the Bundle applied but nothing came up | Manual per-service deployment |
| You already have an identity system and want to connect Themis as an external OIDC provider | Themis as a standalone OIDC service |
| Upgrade, rollback, backup | Upgrade, rollback and backup |
| Something broke; look it up by symptom | Troubleshooting |
| Look up a service's port, probes and external boundary | Services and ports |
| Look up what tools the Agent has, how to register and price them | MCP tool services |
| Look up a service's environment variables | The matching section of Path B: manual per-service deployment; naming, secrets and cross-service references are in Environment variable reference |
| Create the databases by hand / look up table schemas | Database schema — the full init scripts for the three services |
| Where generated images and videos are stored | Object storage and static assets — S3-compatible storage, with Cloudflare R2 as the worked example |
| Read / edit Bundle fields and semantics | Bundle and CRD reference |
| Get a Bundle and Secrets you can fill in directly | Sample manifests — exported from a reference environment, sanitized |
Recommended order for a first installation: overview → one-click deployment → troubleshooting when something goes wrong.
Scope
- Covers the complete steps of installation, integration, upgrade and troubleshooting, plus the variable tables, Bundle fields and reconcile semantics.
- The documentation follows the same release cycle as the images; changes go in with the code commits.
- This documentation contains no environment data whatsoever: every host, domain, port, repository address, account, key, webhook and Secret name is written as a placeholder
<...>. To check the real values, go directly to theenv, ConfigMap and Secret of the corresponding Deployment in the target environment.
Related links
- Product trial: agenti.chat
- Questions:
[email protected]