Config reference
Each entry describes one config setting from the config template. A config setting marked required has no default and must be set. To change a config setting after the instance is installed, see How the config works.
Basics
Section titled “Basics”baseDomain
Section titled “baseDomain”Required. The domain Kindo is served under. Each public address is a name under this domain, such as app.example.com for the domain example.com, unless you give it its own address under How people reach Kindo.
superadminEmail
Section titled “superadminEmail”Required. The email address of the first superadmin. The install prints this person’s key once.
registry
Section titled “registry”Required. The registry Kindo’s charts and images come from.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
host | No | registry.kindo.ai | The registry’s address. It can include a path under the registry, such as mirror.example.com/kindo. Charts and images then come from that path. |
username | Yes | The username Kindo gave you. | |
password | Yes | The password Kindo gave you. |
How people reach Kindo
Section titled “How people reach Kindo”endpoints
Section titled “endpoints”Optional. Moves the Kindo web app, webhooks or file downloads to their own address. Every address you leave out keeps its default.
| Config setting | Default | What it sets |
|---|---|---|
app | https://app.<baseDomain> | Where people open Kindo. It can include a path. |
webhooks | https://api.<baseDomain> | Where outside services send webhooks. It can include a path. |
storage | https://storage.<baseDomain> | Where browsers download files. Azure Blob Storage only, and it can’t include a path. For S3, publicEndpoint under storage sets it. |
Each value is a full URL starting with https. Plain http is accepted only for localhost, a .localhost name or a loopback IP address. When Kindo creates the Ingress, the web app and webhooks addresses can’t include a path.
ingress
Section titled “ingress”Optional. Has Kindo create an Ingress for every public address. Without it, you provide your own routing.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
className | Yes | The IngressClass to use. | |
annotations | No | None | Annotations added to every Ingress. Kindo sets alb.ingress.kubernetes.io/group.order and alb.ingress.kubernetes.io/healthcheck-path itself, so the config refuses them. |
externalDns | No | false | When true, adds an external-dns hostname annotation to each Ingress. |
tls | No | No TLS | How TLS certificates are provided: one of certManager, acm or secret. |
The choices for TLS:
| Choice | Config setting | What it sets |
|---|---|---|
certManager | clusterIssuer | The cert-manager ClusterIssuer that issues the certificates. |
acm | certificateArn | The ARN of the ACM certificate. Works only with className set to alb. |
secret | certificate, privateKey | Your own certificate: the PEM certificate, then any intermediates, and its unencrypted PEM private key. Kindo serves it on every host, so it must cover all of them. Renewing it replaces both values with kindo config edit, then kindo config apply. |
Your cluster
Section titled “Your cluster”secretStore
Section titled “secretStore”Where Kindo keeps its passwords and API keys. Each store takes the config settings below.
Edit the config to change the store before installing. After that, only moving the secret store changes it. Once an instance uses your secrets manager, its config settings can’t change. A move of the store waits for an install that didn’t finish.
| Store | Config setting | Required | What it sets |
|---|---|---|---|
kubernetes | The default. Keeps them in Kubernetes Secrets in the cluster. | ||
vault | address | Yes | The Vault server’s URL. |
path | No | The path in Vault. Defaults to secret. | |
auth | Yes | kubernetes with a Vault role, or token with a secretName. | |
awsSecretsManager | region | Yes | The AWS region of the secrets. |
auth | Yes | podIdentity, assumeRole with a roleArn, or accessKey with a secretName. | |
azureKeyVault | vaultUrl | Yes | The key vault’s URL. |
tenantId | Yes | The Azure tenant ID. | |
auth | Yes | workloadIdentity with a managed identity’s clientId, or servicePrincipal with a secretName. |
A Vault role or an Azure managed identity is bound to this ServiceAccount:
system:serviceaccount:kindo-system:kindo-secret-storeAWS pod identity and assumed roles use the AWS credentials of the External Secrets Operator.
A secret name refers to a Kubernetes Secret in this namespace:
kindo-systemIts keys are:
| Secrets manager | Keys |
|---|---|
| Vault | token |
| AWS Secrets Manager | access-key-id, secret-access-key |
| Azure Key Vault | client-id, client-secret |
See Secret store for setting up your secrets manager.
cluster
Section titled “cluster”Optional.
| Config setting | Default | What it sets |
|---|---|---|
storageClass | The cluster’s default StorageClass | The StorageClass for Kindo’s data volumes. You can’t change it after installing. |
sandboxNodePool | A nodeSelector and tolerations that place agent sandboxes on their own nodes. |
Services you provide
Section titled “Services you provide”postgres
Section titled “postgres”Required. The PostgreSQL servers Kindo creates its databases on. Each server takes an address and an administrator login that can create databases and roles. After installing, you can’t move a database to another server: its host and port stay as they were.
| Server | Required | What it holds |
|---|---|---|
main | Yes | Kindo’s databases. |
auxiliary | No, recommended for production | The databases of Kindo’s supporting services. Without it they go on main. |
hatchet | No, recommended | Hatchet’s database. Hatchet runs Kindo’s background jobs. Without it Hatchet uses auxiliary, or main if there is none. |
All three servers take the same config settings:
| Config setting | Required | Default | What it sets |
|---|---|---|---|
host | Yes | The server’s address. | |
port | No | 5432 | The server’s port. |
tls | No | encrypt | encrypt uses TLS without checking the certificate. verify uses TLS and checks the certificate against public certificate authorities only. none uses no TLS. |
admin.username | Yes | The administrator login. | |
admin.password | Yes | The login’s password. | |
admin.database | No | postgres | The database the login connects to. |
Required. Your Redis server.
| Config setting | Required | What it sets |
|---|---|---|
url | Yes | The connection URL, including the password if the server has one. |
storage
Section titled “storage”Required. Where Kindo keeps uploaded files: S3 or S3-compatible storage, or Azure Blob Storage. Set exactly one of the two below.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
bucket | Yes | The bucket’s name. | |
region | No | The bucket’s region. | |
auth | Yes | accessKey with an accessKeyId and secretAccessKey, irsa with a roleArn for an AWS role Kindo’s pods assume, or podIdentity to use the pods’ own AWS credentials. | |
endpoint | No | For MinIO, GCS or a gateway in front of another store: the store’s URL. | |
publicEndpoint | No | The URL browsers download from, when endpoint is reachable only inside the cluster. Needs endpoint. |
With an IRSA role, the role’s trust policy must allow these ServiceAccounts:
system:serviceaccount:api:apisystem:serviceaccount:task-worker-ts:task-worker-tssystem:serviceaccount:kindo-system:kindo-preflightazureBlob
Section titled “azureBlob”| Config setting | Required | What it sets |
|---|---|---|
account | Yes | The storage account’s name: 3 to 24 lowercase letters and digits. |
container | Yes | The container’s name: 3 to 63 lowercase letters, digits and hyphens, starting and ending with a letter or digit. |
auth | Yes | workloadIdentity with a managed identity’s clientId, or accountKey with the storage account’s access key. |
With workload identity, the managed identity holds the Storage Blob Data Contributor role on the account and a federated credential for the S3 gateway’s ServiceAccount:
system:serviceaccount:kindo-s3proxy:s3proxyBrowsers download files from the storage name under the domain unless you change the storage address under How people reach Kindo.
Required. The mail relay that sends invites, sign-in codes and alerts.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
host | Yes | The relay’s address. | |
port | No | 587 | The relay’s port. On port 465 the connection uses TLS from the start. On any other port it upgrades with STARTTLS when the relay offers it. |
auth | Yes | login with a username and password, or none for a relay that allows Kindo by its source address. | |
fromEmail | Yes | The sender’s address. | |
fromName | No | Kindo | The sender’s name. |
tlsServerName | No | The name to check the relay’s certificate against, when the certificate doesn’t cover host. |
Services Kindo can run for you
Section titled “Services Kindo can run for you”rabbitmq
Section titled “rabbitmq”Required. One of:
| Choice | What it sets |
|---|---|
bringYourOwn | Your broker, with its connection url. |
bundled | Has Kindo run a broker in the cluster. |
Kindo runs a single broker with no failover, so Kindo can’t queue work while it restarts. If you switch from your own broker to Kindo’s, Kindo starts with an empty broker and doesn’t move work still queued on yours.
qdrant
Section titled “qdrant”Optional. Qdrant is Kindo’s vector search. Kindo runs it in the cluster unless you bring your own server.
| Choice | What it sets |
|---|---|
bundled | Has Kindo run it in the cluster. |
bringYourOwn | Your server, with its url and its apiKey if it has one. |
speaches
Section titled “speaches”Optional. Speaches is Kindo’s speech-to-text. Kindo runs it in the cluster unless you turn it off.
| Choice | What it sets |
|---|---|
bundled | Has Kindo run it in the cluster. |
none | Turns it off. |
Features you can turn on any time
Section titled “Features you can turn on any time”modelAccess
Section titled “modelAccess”Optional. Models aren’t added here: superadmins add every model in the superadmin dashboard after the install. This entry lets Kindo reach a model provider through a cloud identity instead of access keys. It supports an IAM role for AWS Bedrock.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
bedrock.auth.irsa.roleArn | Yes | The IAM role Kindo assumes. Its trust policy must allow the ServiceAccount system:serviceaccount:litellm:litellm. | |
bedrock.region | No | The cluster’s region | Where Kindo calls Bedrock models that don’t name their own region. |
integrations
Section titled “integrations”Optional. The integrations to turn on, by catalog name. Kindo refuses unknown names and config settings when the config is saved. To see the names:
kindo integrations list| Config setting | Default | What it sets |
|---|---|---|
enabled | false | Turns the integration on. |
clientId, clientSecret | The OAuth client. An OAuth2 integration needs both before users can connect it. | |
scopes | The integration’s own scopes | The OAuth scopes to request. OAuth2 integrations only. |
An integration that doesn’t use OAuth2 takes only the first config setting above.
tavily
Section titled “tavily”Optional. Turns on web search and web page reads for agents.
| Config setting | What it sets |
|---|---|
apiKey | A Tavily API key. |
googleSignIn
Section titled “googleSignIn”Optional. A Google OAuth client, which adds Google sign-in. Set both config settings or neither.
| Config setting | What it sets |
|---|---|
clientId | The OAuth client ID. |
clientSecret | The OAuth client secret. |
Optional. Sends audit events to a syslog receiver.
| Config setting | Required | Default | What it sets |
|---|---|---|---|
syslog.host | Yes | The receiver’s address. | |
syslog.port | No | 514 | The receiver’s port. |
syslog.transport | No | udp | tls, tcp or udp. With tls, caPem holds the PEM certificate of the authority that signed the receiver’s certificate, unless a public authority signed it. |
