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

1. Add Kathara public key to your keyring: sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 21805A48E6CBBA6B991ABE76646193862B759810
2. Add the kathara repo to your repos:
   • If you have Ubuntu: sudo add-apt-repository ppa:katharaframework/kathara
   • If you have other Debian-based distos:
     • 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 
     

     You can do it by running 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

Red Hat-based

1. Download the .rpm file to a directory of your choice from a Release.
2. On a terminal, type sudo rpm -i <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, for example: makepkg -si or yay -Syu kathara
   • NOTE: Building Kathará from source code requires at least 8GB of RAM, due to Nuitka's gcc optimizations.