Skip to main content
Version: 1.x


minimal footprint


Gefyra is tested under Windows, MacOS and Linux. The command line tool can be installed with a binary executable. Please find your preferred operating system below.


To use Gefyra you need:

  • Docker client API compatible container runtime (Docker/Docker Desktop/Colima/Rancher Desktop with moby engine)
    • Overlay networking support (not available on rootless Docker)
  • Kubernetes cluster with a reachable node port 31820/UDP

Install Gefyra on MacOS


brew tap gefyrahq/gefyra
brew install gefyra

Manual Installation

curl -sSL | sh -

Install Gefyra on Linux

curl -sSL | sh -

Install Gefyra on Windows

You can download the latest release from on your local machine.

Chocolatey will be available soon. If you can support this project with packaging and distributing for Windows please get in touch!


Docker Desktop Extension

The Gefyra Docker Desktop Extension is available on the Docker Desktop extension marketplace However, you can also install it by running the following command:

docker extension install gefyra/docker-desktop-extension:latest

For more details see Docker Desktop Extension.

Using Python Package Index

You can install Gefyra with pip:

pip install gefyra --upgrade