> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odigos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Odigos Central using the CLI or Helm chart to manage multi-cluster observability from a single control plane.

You can install Odigos Central using the CLI or Helm chart.

<Tabs>
  <Tab title="CLI">
    Use the `odigos pro central install` command with `--set` flags:

    ```bash theme={null}
    odigos pro central install --set onPremToken=<token>
    ```

    This installs:

    * central-backend
    * central-ui
    * redis (for state)
    * keycloak (as identity provider)

    ### CLI Flags

    | Flag                                   | Default                 | Description                                                                     |
    | -------------------------------------- | ----------------------- | ------------------------------------------------------------------------------- |
    | `--set onPremToken`                    | (required)              | Your Odigos Enterprise license token                                            |
    | `--set centralProxy.centralBackendURL` | (optional)              | URL of the central backend                                                      |
    | `--set auth.externalUrl`               | `http://localhost:8081` | Browser-accessible URL of the Central Backend for SSO redirect flows            |
    | `--set auth.adminPassword`             | (auto-generated)        | Admin password for Keycloak. If not provided, a random password is generated    |
    | `--set auth.adminUsername`             | `admin`                 | Admin username for Keycloak                                                     |
    | `--set cloudConnectors.enabled`        | `false`                 | Enable [Cloud Connectors](/cloud-connectors/enable) (controller, Postgres, CRD) |
    | `--namespace`, `-n`                    | `odigos-central`        | Target namespace for installation                                               |
    | `--version`                            | (current)               | Specify a specific version to install                                           |

    **Example with all options:**

    ```bash theme={null}
    odigos pro central install \
      --set onPremToken=<token> \
      --namespace odigos-central \
      --version v1.0.0
    ```
  </Tab>

  <Tab title="Helm">
    Add the Odigos Helm repository and install:

    ```bash theme={null}
    helm repo add odigos https://odigos-io.github.io/odigos/
    helm repo update
    helm upgrade --install odigos-central odigos/odigos-central \
      --namespace odigos-central \
      --create-namespace \
      --set onPremToken=<token>
    ```

    For production deployments, consider using a `values.yaml` file:

    ```yaml theme={null}
    onPremToken: "<your-token>"

    auth:
      externalUrl: "https://central.example.com"  # Browser-accessible URL for SSO redirects
      adminUsername: admin
      adminPassword: "<your-password>"
      persistence:
        enabled: true
        size: 2Gi
        storageClassName: "gp3"

    centralBackend:
      autoscaling:
        enabled: true
        minReplicas: 2
        maxReplicas: 10
      resources:
        requests:
          cpu: 200m
          memory: 256Mi
        limits:
          cpu: 1000m
          memory: 1Gi

    centralUI:
      resources:
        requests:
          cpu: 100m
          memory: 128Mi
        limits:
          cpu: 500m
          memory: 512Mi
    ```

    Then install with:

    ```bash theme={null}
    helm upgrade --install odigos-central odigos/odigos-central \
      --namespace odigos-central \
      --create-namespace \
      -f values.yaml
    ```
  </Tab>
</Tabs>

## Optional: Cloud Connectors

Cloud Connectors are disabled by default. To discover and instrument cloud workloads (AWS, GCP, and more) from Central, enable the feature at install or upgrade time:

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    odigos pro central install \
      --set onPremToken=<token> \
      --set cloudConnectors.enabled=true \
      --set cloudConnectors.postgres.password=<strong-password> \
      --set cloudConnectors.postgres.persistence.enabled=true \
      --set cloudConnectors.postgres.persistence.size=20Gi \
      --set cloudConnectors.postgres.persistence.storageClassName=
    ```

    On an existing install:

    ```bash theme={null}
    odigos pro central upgrade \
      --set cloudConnectors.enabled=true \
      --set cloudConnectors.postgres.password=<strong-password> \
      --set cloudConnectors.postgres.persistence.enabled=true \
      --set cloudConnectors.postgres.persistence.size=20Gi \
      --set cloudConnectors.postgres.persistence.storageClassName=
    ```
  </Tab>

  <Tab title="Helm">
    ```bash theme={null}
    helm upgrade --install odigos-central odigos/odigos-central \
      --namespace odigos-central \
      --reuse-values \
      --set cloudConnectors.enabled=true \
      --set cloudConnectors.postgres.password=<strong-password> \
      --set cloudConnectors.postgres.persistence.enabled=true \
      --set cloudConnectors.postgres.persistence.size=20Gi \
      --set cloudConnectors.postgres.persistence.storageClassName=
    ```
  </Tab>
</Tabs>

See [Enable Cloud Connectors](/cloud-connectors/enable) for PostgreSQL settings, verification steps, and full values.