Using a Self-Hosted Cloud

Connect any cloud account or on-premise setup to Bluebricks using the self-hosted runner for full infrastructure orchestration

A Self-Hosted Cloud enables you to connect any cloud account or on-premise setup to a collection on Bluebricks. It requires installing the Bluebricks Deployments Controller (BDC): a Kubernetes operator that orchestrates IaC tasks in your own cluster.

Prerequisites

• Kubernetes 1.28+

• Helm 3.8+

• kubectl configured and pointing at your target cluster

• A Bluebricks collection

Step 1: Install BDC in your cluster

Install the Bluebricks Deployments Controller using Helm:

helm install bdc \
  oci://europe-docker.pkg.dev/bbx-registry-prod/helm/bluebricks-deployments-controller

For custom configuration options (resource limits, environment variables, storage), see the BDC Helm Chart reference and the full Self-Hosted Runner guide.

Step 2: Verify the installation

Check that the BDC pods are running:

kubectl get pods -n bluebricks

View the controller logs to confirm it started successfully:

kubectl logs -f deployment/bluebricks-deployments-controller -n bluebricks

Step 3: Register the cluster

Run the Bluebricks registration script to connect your cluster to the platform:

/bin/bash -c "$(curl -fsSL https://brickscli.s3.eu-west-1.amazonaws.com/releases/latest/self-hosted-register.sh)"

The script will verify your Kubernetes context and guide you through a wizard to collect the necessary details. For more information on how registration and authentication work, see Registration and Authentication.

Step 4: Connect in the Bluebricks app

After registration, add the self-hosted cloud account in the Bluebricks app:

1. Click "Connect Cloud" on the collection you want to link

2. Select Self-Hosted as the Cloud Provider

3. Fill in the required fields:

Field	Required	Description
Name	Yes	A display name for this cloud account
Service account namespace	Yes	Kubernetes namespace for the BDC service account (default: bluebricks)
Service account name	No	Name of the BDC service account (default: bluebricks-deployments-controller-sa)
Cluster name	Yes	Name of the target cluster. Find it with: kubectl config current-context
Cluster OIDC URL	Yes	The OIDC issuer URL for your cluster. Find it with: kubectl get --raw '/.well-known/openid-configuration' | jq -r .issuer

1. Click "Connect & Create" to complete the setup

Managing cloud accounts

Bluebricks app

From the collection detail page you can:

1. View account details: click the cloud account section to see provider attributes (read-only after creation).

2. Switch accounts: click Edit on the cloud account section, then select a different account or create a new one.

3. Disconnect: expand the disconnect section and confirm to remove the cloud account from the collection. This does not delete the account itself.

CLI

Learn more about managing cloud accounts

Next steps

• Connect your Cloud: overview of all cloud connection types

• Bluebricks Self-Hosted Runner: full BDC architecture and configuration

• CLI Reference: bricks clouds