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á running 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á running 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" |  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" |  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" |  tee -a /etc/apt/sources.list.d/kathara.list
     

3. Update your apt cache by running sudo apt update
4. Install Kathará running 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
5. Install Kathará running sudo apt install kathara

Red Hat-based

1. Download the .rpm file to a directory of your choice from a Release.
2. On a terminal, type sudo rpm -U <KATHARA_RPM_FILE>.rpm in the chosen directory
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. On a terminal, type sudo pacman -U <KATHARA_PKG_FILE>.pkg.tar.zst in the chosen directory

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.9 installed (both from AUR or from source).
   • NOTE: Building Kathará from source requires at least 8GB of RAM, due to Nuitka's gcc optimizations.