# Installing the multi-cluster extension

Buoyant Enterprise for Linkerd provides a hardened version of the [multi-cluster
extension](https://linkerd.io/2.20/features/multicluster/).
This guide demonstrates how to install this extension.

## Prerequisites

- Two Kubernetes clusters with [Buoyant Enterprise for Linkerd](/buoyant-enterprise-linkerd/latest/installation/)
  installed
- A control plane installation in each cluster that shares a common [trust
  anchor](https://linkerd.io/2.20/tasks/generate-certificates/#trust-anchor-certificate)
- The `BUOYANT_LICENSE` environment variable set, with functioning BEL CLI

> [!NOTE]
> If you have an existing control plane installation, see the
> [trust anchor bundle](https://linkerd.io/2.20/tasks/installing-multicluster/#trust-anchor-bundle)
> documentation at linkerd.io to understand what is required.

## Install the multi-cluster extension

Start by creating a `values.yaml` file that contains the `controllers` value
listing the links that will perform the service mirroring for each one of the
target clusters you wish to connect to. In this example, we'd like to be able to
access the `east` cluster from the `west` cluster:

`values.yaml`:

```yaml
controllers:
  - link:
      ref:
        name: east
```

Next add the linkerd-buoyant repo:

```bash
helm repo add linkerd-buoyant https://helm.buoyant.cloud
helm repo update
```

Now we can install the multi-cluster extension.

**CLI:**

In the `west` cluster, run:

```bash
linkerd multicluster install -f values.yaml | \
  kubectl apply -f -
```

And in the `east` cluster, run:

```bash
linkerd multicluster install | \
  kubectl apply -f -
```

**Helm:**

In the `west` cluster, run:

```bash
helm install linkerd-multicluster \
  --create-namespace \
  --namespace linkerd-multicluster \
  --values values.yaml \
  linkerd-buoyant/linkerd-enterprise-multicluster
```

And in the `east` cluster, run:

```bash
helm install linkerd-multicluster \
  --create-namespace \
  --namespace linkerd-multicluster \
  linkerd-buoyant/linkerd-enterprise-multicluster
```

## Verify your installation

To verify that everything has started up successfully, run this on each cluster:

```bash
linkerd multicluster check
```

## Linking clusters and exporting services

Now that the multi-cluster extention is installed, you need to link the clusters
and export your services. You can complete these steps by following [Step
2][step-2] and [Step 3][step-3] in the "Installing Multi-cluster Components"
guide at linkerd.io.

[step-2]: https://linkerd.io/2.20/tasks/installing-multicluster/#step-2-link-the-clusters
[step-3]: https://linkerd.io/2.20/tasks/installing-multicluster/#step-3-export-services

## Learning more

More details about the multi-cluster extension can be found at
[linkerd.io](https://linkerd.io/2.20/features/multicluster/).
