The distro-hosted bundle

Kubernetes distribution, hosted version

This is a Cozystack platform configuration intended for use as a Kubernetes distribution, designed for installation on existing Kubernetes clusters.

This configuration can be used with kind and any cloud-based Kubernetes clusters. It does not include CNI plugins, virtualization, storage, or multitenancy.

Example configuration

apiVersion: v1
kind: ConfigMap
metadata:
  name: cozystack
  namespace: cozy-system
data:
  bundle-name: "distro-hosted"
  root-host: example.org
  api-server-endpoint: https://192.168.100.10:6443

Configuration parameters

option	description
`bundle-name`	Name of bundle to use for installation
`bundle-disable`	Comma-separated list of disabled components from the bundle. Read more about this option in “how to disable some components from bundle”.
`values-<component>`	JSON or YAML formated values passed to specific component installation. Read more about this option in “how to overwrite parameters for specific components”.
`root-host`	the main domain for all services created under Cozystack, such as the dashboard, Grafana, Keycloak, etc.
`api-server-endpoint`	used for generating kubeconfig files for your users. It is recommended to use globally accessible IP addresses instead of local ones.
`telemetry-enabled`	used to enable telemetry feature in Cozystack (default: `true`)

Refer to the Bundles reference page to learn how to use generic bundle options.

Last modified 2025-06-19: [docs] Fix link to bundles reference page (2a916e9)