| title | Self-host install |
|---|---|
| description | Install Agyn on your own Kubernetes cluster. |
| order | 2 |
Skip this section if you use Agyn Cloud — your platform is already running. Continue to Administer instead.
Agyn runs on Kubernetes. There are two install paths:
| Path | When to use it |
|---|---|
| Quick bootstrap | Local development, demos, evaluation. Provisions a complete k3d cluster with every dependency via Terraform and Argo CD. One command. |
| Production install | Real deployments. Reuses the same Terraform stacks against your own cluster, OIDC, and DNS, with the in-cluster Postgres / S3 / OpenFGA optionally replaced by managed services. |
- Prerequisites — what you need before installing.
- Quick bootstrap — one-command install for development and demos.
- Production install — bring bootstrap up against your own cluster, OIDC, and domain.
- First admin — how the cluster admin user is provisioned at install.
- Upgrades — upgrade the platform installed via bootstrap.
- Uninstall — remove Agyn cleanly.
Once Agyn is running:
- Sign into the Console at the URL printed by the installer.
- Follow First admin to bind your OIDC subject to the cluster admin role.
- Continue to Administer to create your first organization, register runners, and configure agents.
- Review Operate for day-2 concerns (backups, monitoring, security).