Liqo enables the creation of arbitrary multi-cluster topologies, proposing a seamless multi-cluster model which dynamically allows the pods and services to offload on remote clusters.

This section presents several tutorials that guide the discovery and use of the key Liqo features.

System Requirements

Before starting to run the following tutorials, you should have installed the following software on your system:

  • Docker, the container runtime.
  • Kubectl, the command-line tool for Kubernetes.
  • Helm, the package manager for Kubernetes.
  • curl, to interact with the cluster through HTTP/HTTPS. In Ubuntu systems, you can install it via a simple sudo apt update && sudo apt install -y curl.

In addition, you should install the liqoctl command-line tool for Liqo.

The following tutorials were tested on Linux, macOS, and Windows (WSL2 and Docker Desktop).


  • Basic: a first Hello World-style tutorial introducing the basic Liqo features. In this tutorial, you will set up multiple clusters and establish the first peering among them.
  • Advanced: a more in-depth Dominate the world-style tutorial showing how to profit from Liqo advanced features.