Quickstart

Start with Kind, a development cluster, or a non-production namespace.

1. Open Remote Operator setup

In your Alien project, open Deployments → Remote Operator and choose manual setup.

Select the operations your team needs. Start with one read-only Kubernetes diagnostic. Add remediation, cloud access, private-service connections, or logs only when you intend to test them.

2. Add the generated template

Wait for Alien to prepare the project-specific operator image, then download byoc-operator.yaml.

your-chart/
├── Chart.yaml
├── values.yaml
└── templates/
    ├── deployment.yaml
    ├── service.yaml
    └── byoc-operator.yaml   ← add this

Review the rendered resources before installing them.

3. Create test values

Enter a name for the test installation. The dashboard generates values shown once:

remoteOperator:
  registrationToken: "..."
  encryptionKey: "..."
  collectorToken: "..."

Save them as byoc-operator-values.yaml outside version control.

4. Install the chart

helm upgrade --install test-installation <path-to-chart> \
  --namespace test-installation --create-namespace \
  --values byoc-operator-values.yaml

5. Verify the whole path

The dashboard waits for a fresh operator heartbeat. When it connects, verify:

• the operator pod is ready on the expected image;
• the installation appears in Alien;
• enabled connections report healthy;
• one read-only Kubernetes diagnostic succeeds; and
• the log collector is healthy if you enabled it.

Delete the local values file when the test is done. Generate different values for every installation.