In this article, you will find the steps that you need to perform to install the HEIMDAL Agent on a Ubuntu/Debian machine. The current HEIMDAL Agent version has been tested on 23.04, 24.04 LTS, 25.10, and 26.04. The installation process requires sudo permissions.
INSTALLING THE HEIMDAL AGENT using the installation script
Starting with Ubuntu 22.04, the HEIMDAL Agent requires libssl1.0 or libssl1.1 to work. Before running the HEIMDAL Agent install script, you need to make sure you are running libssl1.0 or libssl1.1. In case it's not installed, you can install it using the steps below:
1. Download the HEIMDAL Agent installation script from the following URL:
https://prodcdn.heimdalsecurity.com/setup-linux/install-heimdal.sh
You can achieve this from the Terminal by using the following command line:
wget "https://prodcdn.heimdalsecurity.com/setup-linux/install-heimdal.sh"
2. Make sure you are in the same folder where the HEIMDAL Agent installation script has been downloaded, and run the following command line:
sudo sh install-heimdal.sh 00000000-0000-0000-0000-000000000000
Replace 00000000-0000-0000-0000-000000000000 with your HEIMDAL license key (displayed in the HEIMDAL Dashboard -> Guide section).
3. To see if the HEIMDAL Agent is running, run the following command line:
sudo systemctl status heimdal-clienthost