Install from packages

Ubuntu 24.04 is the only officially supported Linux distribution for the moment. Prebuilt packages are available for both patched kernel and Tempesta FW. Kernel package is build with patches from Ubuntu maintainers and kernel configuration.

We support packages only for stable versions. Please install from sources if you need the current master build.

Since Tempesta FW is implemented as in-kernel module and it is under development, issues in it can affect stability of the kernel and may lead to a kernel crush. As a solution kdump is set as dependency for Tempesta FW. It allows to save crash dump information to /var/crash/%Date% and reboot system after the crash. It is highly recommended to enable kdump during install of kdump-tools package. kdump requires system reboot after installation.

Using apt repo

Run the next commands to automatically install Tempesta FW:

sudo install -m 0755 -d /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/tempesta.asc https://tempesta-tech.com:8081/repository/public-keys/keys/public.key
sudo chmod a+r /etc/apt/keyrings/tempesta.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/tempesta.asc] \
https://tempesta-tech.com:8081/repository/tempesta/ focal main" | sudo tee /etc/apt/sources.list.d/tempesta.list
sudo apt update && sudo apt upgrade
sudo apt install tempesta-fw
echo 'GRUB_TERMINAL="serial console"' | sudo tee -a /etc/default/grub
echo "GRUB_DEFAULT='Advanced options for Ubuntu>Ubuntu, with Linux 5.10.35.tfw-562f4af'" | sudo tee -a /etc/default/grub
sudo update-grub
sudo reboot

Check is tempesta-fw working fine

systemctl status tempesta-fw

Expected output

● tempesta-fw.service - High performance HTTP proxy server
     Loaded: loaded (/usr/lib/systemd/system/tempesta-fw.service; enabled; preset: enabled)
     Active: active (exited) since Tue 2025-04-08 09:34:28 UTC; 5min ago
    Process: 816 ExecStart=/lib/tempesta/scripts/tempesta.sh --start (code=exited, status=0/SUCCESS)
   Main PID: 816 (code=exited, status=0/SUCCESS)
        CPU: 4.870s

Apr 08 09:34:23 deb1 tempesta.sh[816]: ...load Tempesta modules
Apr 08 09:34:23 deb1 tempesta.sh[816]: Loading Tempesta kernel modules...
Apr 08 09:34:23 deb1 tempesta.sh[816]: Loading module tempesta_lib
Apr 08 09:34:23 deb1 tempesta.sh[816]: Loading module tempesta_tls
Apr 08 09:34:24 deb1 tempesta.sh[816]: Loading module tempesta_db
Apr 08 09:34:24 deb1 tempesta.sh[816]: Loading module tempesta_fw tfw_cfg_path=/lib/tempesta/etc/tempesta_tmp.conf
Apr 08 09:34:27 deb1 tempesta.sh[816]: ...compile html templates for JS challenge
Apr 08 09:34:27 deb1 tempesta.sh[816]: ...start Tempesta FW
Apr 08 09:34:28 deb1 tempesta.sh[816]: done
Apr 08 09:34:28 deb1 systemd[1]: Finished tempesta-fw.service - High performance HTTP proxy server.

Run the next commands to remove Tempesta FW:

sudo apt purge tempesta-fw -y

And run the next commands to remove kernel patch:

sudo apt purge linux-headers-5.10.35.tfw-562f4af linux-image-5.10.35.tfw-562f4af -y
sudo apt autoremove -y
sudo update-grub
sudo reboot

Running Tempesta FW

First, reboot to tempesta-patched kernel.

Then, edit Tempesta FW configuration file:

sudo vim /etc/tempesta/tempesta_fw.conf

More information about configuration is available in Readme.

Finally, systemd unit files can be used for convenient management of Tempesta FW. To start and stop Tempesta FW use the next commands:

systemctl start tempesta-fw
systemctl stop tempesta-fw

To add or remove Tempesta FW from bootup process, use:

systemctl enable tempesta-fw
systemctl disable tempesta-fw

See also Run & stop for more systemd calls.