Installation instructions

Python versions >= 3.6 are supported. See the GitHub Action for the matrix we test against.

We provide RPM packages for Fedora, CentOS/RHEL distribution. CEKit installation on other platforms is still possible via pip.

RPM packages are distributed via regular repositories in case of Fedora and the EPEL repository for CentOS/RHEL.

Tip

You can see latest submitted package updates submitted in Bodhi.

Warning

Make sure you read the dependencies chapter which contains important information about how CEKit dependencies are handled!

Fedora

Note

Supported versions: 35+.

CEKit is available from regular Fedora repositories.

dnf install cekit

CentOS / RHEL

Note

Supported versions: 7.x, 8.x

CEKit is available from the EPEL repository.

yum install epel-release
yum install cekit

Note

odcs-client is a runtime requirement when using content_sets but it is not available under Python 3 as an RPM for EPEL 7. Therefore the recommendation is to install it via Pip e.g.

yum install python3-devel gcc krb5-devel
pip install odcs

Other systems

We strongly advise to use Virtualenv to install CEKit. Please consult your package manager for the correct package name.

To create custom Python virtual environment please run following commands on your system:

# Prepare virtual environment
virtualenv ~/cekit
source ~/cekit/bin/activate

# Install CEKit
# Execute the same command to upgrade to latest version
pip install -U cekit

# Now you are able to run CEKit
cekit --help

Note

Every time you want to use CEKit you must activate CEKit Python virtual environment by executing source ~/cekit/bin/activate

If you don’t want to (or cannot) use Virtualenv, the best idea is to install CEKit in the user’s home with the --user prefix:

pip install -U cekit --user

Note

In this case you may need to add ~/.local/bin/ directory to your $PATH environment variable to be able to run the cekit command.

Note

For Debian based distros, you may need to pre-install the libkrb5-dev apt package before installing cekit using pip (either inside or outside a virtualenv). You can do this by typing:

sudo apt install libkrb5-dev