Skip to main content

Linux Installation

We ship Headlamp the Linux desktop in several formats: Flatpak, AppImage, Tarballs.

Flatpak​

Flatpak gives an isolated and bundled way of running Headlamp, with decoupled runtime updates (besides other benefits).

Make sure you install Flatpak and enable the flathub repository, then install Headlamp with the following command:

flatpak install io.kinvolk.Headlamp

For running it, just launch it as usually in your Linux desktop, or run:

flatpak run io.kinvolk.Headlamp

Upgrading​

To upgrading Headlamp when it's installed via Flatpak, run:

flatpak update io.kinvolk.Headlamp

Running External Tools​

When using tools like az, aws, gcloud, etc. from e.g. kubeconfig user's exec, Flatpak will need to run these tools from outside the sandbox. For that to work, you need to grant the talk-name of org.freedesktop.Flatpak. To do this, use the Flatseal application to change Headlamp's permissions, or run the following command (before running Headlamp):

sudo flatpak override --talk-name=org.freedesktop.Flatpak io.kinvolk.Headlamp

AppImage​

Headlamp can be used as an AppImage by downloading and running it directly.

To download, choose the AppImage file from the latest release page. You can then run it with the following command (exemplified for the AMD64, 0.16.0 version):

./Headlamp-0.16.0-linux-x64.AppImage

Tarballs​

To run Headlamp from one of the tarballs, first download the tarball for the latest release. Then, extract the contents from it and run the headlamp binary in the resulting folder (exemplified below for the AMD64, 0.16.0 version):

tar xvzf ./Headlamp-0.16.0-linux-x64.tar.gz
cd Headlamp-0.16.0-linux-x64
./headlamp