Skip to content

Installation

External-secrets runs within your Kubernetes cluster as a deployment resource. It utilizes CustomResourceDefinitions to configure access to secret providers through SecretStore resources and manages Kubernetes secret resources with ExternalSecret resources.

Note: The minimum supported version of Kubernetes is 1.16.0. Users still running Kubernetes v1.15 or below should upgrade to a supported version before installing external-secrets.

Installing with Helm

The default install options will automatically install and manage the CRDs as part of your helm release. If you do not want the CRDs to be automatically upgraded and managed, you must set the installCRDs option to false. (e.g. --set installCRDS=false)

Uncomment the relevant line in the next steps to disable the automatic install of CRDs.

Option 1: Install from chart repository

helm repo add external-secrets https://charts.external-secrets.io

helm install external-secrets \
   external-secrets/external-secrets \
    -n external-secrets \
    --create-namespace \
  # --set installCRDs=false

Option 2: Install chart from local build

Build and install the Helm chart locally after cloning the repository.

make helm.build

helm install external-secrets \
    ./bin/chart/external-secrets.tgz \
    -n external-secrets \
    --create-namespace \
  # --set installCRDs=false

Effortless Installation via 01Cloud

Simplifying the process further, you can effortlessly install the external-secret package within the 01Cloud within few clicks. The procedure is streamlined and user-friendly, requiring only a few steps:

  1. Organization Setup: Begin by creating an organization within 01Cloud, providing a structured environment for your operations.

  2. Cluster Integration: Import an existing cluster or create a new one directly through the 01Cloud system. This flexibility allows you to choose the provider that best suits your needs.

  3. Package Installation: Once your cluster is ready, simply install the external-secret package with ease. This package equips your 01Cloud application with the capabilities to seamlessly manage external secrets.

For more detailed guidance on the installation process, you can refer to the documentation available here.