Install Liqo

Install Liqo on your clusters

In this section, you can install Liqo on the clusters just created.

Define your cluster labels

First, you should define the cluster labels that each cluster remotely exports during the peering process. As detailed in the namespace replication page, each cluster can expose some labels meaningful, enabling the possibility to select it during the offloading configuration.

In this example, you export two labels for every cluster:

KeyDescription the region to which that cluster belongs. the cloud provider that manages that cluster.

Installing Liqo

You can install Liqo on the first cluster:

liqoctl install kind --cluster-name cluster-1 \
   --cluster-labels=""="eu-west",""="provider-1" \

The “–namespace” option sets the namespace name in which the Liqo control plane is deployed.

namestringSet a mnemonic name for your cluster.
cluster-labelsmapSet labels attached to the cluster when exposed remotely.
enable-lan-discoveryboolIf set to true, automatically join discovered cluster exposing the Authentication Service with a valid certificate.

You can find additional details about the possible chart values by looking at the dedicated section.

If you set the –enable-lan-discovery to true, Liqo will automatically discover the other clusters and create a full mesh topology between them. However, in this tutorial, the –enable-lan-discovery parameter is set to False to let you discover how to manually enable and disable peerings according to the Liqo selective peering feature.

You should install Liqo also on the other two clusters:

liqoctl install kind --cluster-name cluster-2 \
   --cluster-labels=""="us-west",""="provider-2" \
liqoctl install kind --cluster-name cluster-3 \
   --cluster-labels=""="eu-east",""="provider-3" \

liqoctl commands take a couple of minutes to complete. If liqoctl returns successfully, the installation process is complete.

Check installation state

Liqo should be installed on all three clusters.

You can check by typing for example:

kubectl get pods -n liqo

Each cluster should provide an output similar to this:

NAME                                          READY   STATUS
liqo-auth-7df65db559-jtmvb                    1/1     Running
liqo-controller-manager-c7b996f8f-m5wgd       1/1     Running
liqo-crd-replicator-7d7b66d566-7z9lm          1/1     Running
liqo-discovery-5f7d7fffdd-wbvt2               1/1     Running
liqo-gateway-6f4fb8dcd9-pqx2d                 1/1     Running
liqo-network-manager-65dd9599d6-dvfgw         1/1     Running
liqo-route-sn5c8                              1/1     Running
liqo-webhook-6bcc9d4f76-5dwmw                 1/1     Running

If Liqo is installed and running on your clusters, you can start to peer your clusters.