Liqo enables the creation of virtual clusters that span across multiple real clusters (or portions of them), without any limitation in the resulting topology. Thanks to its seamless multi-cluster model, pods and services can float freely on the resulting virtual continuum, landing on any available cluster (either local or remote), and communicate to each other independently of their location.

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

System Requirements

Before starting the tutorials below, 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, 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.