Linux

Kathará can be installed on all main Linux distributions.

Prerequisites

By default, Kathará depends on Docker, but can also leverage on Kubernetes, using Megalos.

1. To install Docker, you can follow this guide
2. (suggested) Install xterm terminal emulator (usually sudo apt install xterm or sudo yum install xterm or sudo pacman -S xterm), that is used by default
   • You can also specify a different terminal emulator by using kathara settings command

Debian-based

We provide binaries for both amd64 and arm64.

Ubuntu

1. Add Kathará public key to your keyring:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 21805A48E6CBBA6B991ABE76646193862B759810

2. Add the Kathará repo to your repos:

sudo add-apt-repository ppa:katharaframework/kathara

3. Update your apt cache by running:

sudo apt update

4. Install Kathará:

sudo apt install kathara

Debian 9 and Debian 10

1. Add Kathará public key to your keyring:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 21805A48E6CBBA6B991ABE76646193862B759810

2. Add the Kathará repository:
   • Create a kathara.list file in /etc/apt/sources.list.d and put inside the following lines:

   deb http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main 
   deb-src http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main 
   

   • Or run the following commands:

   echo "deb http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main" | sudo tee /etc/apt/sources.list.d/kathara.list
   echo "deb-src http://ppa.launchpad.net/katharaframework/kathara/ubuntu bionic main" | sudo tee -a /etc/apt/sources.list.d/kathara.list
   

3. Update your apt cache by running:

sudo apt update

4. Install Kathará:

sudo apt install kathara

Debian 11

1. Add Kathará public key to your keyring:

wget -qO - "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x21805a48e6cbba6b991abe76646193862b759810" | sudo gpg --dearmor -o /usr/share/keyrings/ppa-kathara-archive-keyring.gpg

2. Add the Kathará repository:
   • Create a kathara.list file in /etc/apt/sources.list.d and put inside the following lines:

     deb [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main 
     deb-src [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main 
     

   • Or run the following commands:

     echo "deb [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/kathara.list
     echo "deb-src [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main" | sudo tee -a /etc/apt/sources.list.d/kathara.list
     

3. Update your apt cache by running:

sudo apt update

4. Install Kathará:

sudo apt install kathara

Debian 12

1. Add Kathará public key to your keyring:

wget -qO - "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x21805a48e6cbba6b991abe76646193862b759810" | sudo gpg --dearmor -o /usr/share/keyrings/ppa-kathara-archive-keyring.gpg

2. Add the Kathará repository:
   • Create a kathara.list file in /etc/apt/sources.list.d and put inside the following lines:

     deb [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu jammy main 
     deb-src [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu jammy main 
     

   • Or run the following commands:

     echo "deb [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/kathara.list
     echo "deb-src [ signed-by=/usr/share/keyrings/ppa-kathara-archive-keyring.gpg ] http://ppa.launchpad.net/katharaframework/kathara/ubuntu jammy main" | sudo tee -a /etc/apt/sources.list.d/kathara.list
     

3. Update your apt cache by running:

sudo apt update

4. Install Kathará:

sudo apt install kathara

Kali Linux

1. Add Kathará public key to your keyring:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 21805A48E6CBBA6B991ABE76646193862B759810

2. Add the Kathará repository:
   • Create a kathara.list file in /etc/apt/sources.list.d and put inside the following lines:

   deb http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main 
   deb-src http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main 
   

   • Or run the following commands:

   echo "deb http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/kathara.list
   echo "deb-src http://ppa.launchpad.net/katharaframework/kathara/ubuntu focal main" | sudo tee -a /etc/apt/sources.list.d/kathara.list
   

3. Manually install libmpdec2, libreadline7 and libffi6 dependencies downloading the .deb files:

   wget http://ftp.it.debian.org/debian/pool/main/m/mpdecimal/libmpdec2_2.4.2-2_amd64.deb
   wget http://ftp.de.debian.org/debian/pool/main/libf/libffi/libffi6_3.2.1-9_amd64.deb
   wget http://ftp.de.debian.org/debian/pool/main/r/readline/libreadline7_7.0-5_amd64.deb
   sudo apt install ./libmpdec2_2.4.2-2_amd64.deb
   sudo apt install ./libffi6_3.2.1-9_amd64.deb
   sudo apt install ./libreadline7_7.0-5_amd64.deb
   

4. Update your apt cache by running:

sudo apt update

4. Install Kathará:

sudo apt install kathara

Red Hat-based

1. Download the .rpm file to a directory of your choice from a Release.
2. Enter the directory and, on a terminal, type:

sudo rpm -U <KATHARA_RPM_FILE>.rpm

3. Before using Kathará, you MUST stop firewalld service, running:

sudo systemctl stop firewalld

Arch-based

From Binary File

1. Download the .pkg.tar.zst file to a directory of your choice from a Release.
2. Enter the directory and, on a terminal, type:

sudo pacman -U <KATHARA_PKG_FILE>.pkg.tar.zst

From AUR (Source Files)

1. Clone the Kathará AUR Repository:

git clone https://aur.archlinux.org/kathara.git

2. Enter the directory

cd kathara

3. Run the shell command to build the package:

makepkg -si

This will also install the package.

• NOTE: Make sure you have Python 3.11 installed (both from AUR or from source).
• NOTE: Building Kathará from source requires at least 8GB of RAM, due to Nuitka's gcc optimizations.