Exegol Docs

Appearance

Installing Exegol on openSUSE ​

NOTE

This page was brought to you by a community member and wasn't "mass-tested" yet. Feedback on whether it works properly (or not) would be greatly appreciated (please head over to our Discord server for that).

Exegol is installed through two main steps:

  1. Install the Python wrapper (the "brains")
  2. Install at least one Exegol image (the "muscle")

1. Requirements ​

Git, Python3 and Pipx can be installed with the following command:

bash
sudo zypper refresh && sudo zypper install -y git python3 python313-pipx

Ensure pipx is in PATH and reload the shell

bash
pipx ensurepath && exec $SHELL

While we always advise to refer to the official documentation, the following one-liner can be used to install Docker quickly.

bash
sudo zypper install -y docker
WARNING

Docker "Rootless mode" is not supported by Exegol as of yet. Don't follow that part.

Once docker is installed, it needs to be started.

bash
# start docker
sudo systemctl start docker 

# configure docker to start at boot
sudo systemctl enable --now docker

2. Wrapper install ​

Install Exegol in an isolated environment using pipx, a tool that allows you to easily install and run Python applications in isolated environments, keeping them separate from your system Python and other packages.

bash
pipx install exegol

Before using Exegol, you will need to read and accept the End User License Agreement (EULA). This will be prompted on the first run of the wrapper, and until it's confirmed.

To interact with docker, the wrapper needs proper permissions. You must either run Exegol with sudo (preferred), or have your user be a member of the docker group (which dangerously allows your user to basically have root permissions all the time).

The following command shows how to do that with bash, but it can be adapted to any shell. Once the alias is set, you can apply it your current session.

Add the following alias to your ~/.bashrc file:

bash
echo "alias exegol='sudo -E \$HOME/.local/bin/exegol'" >> ~/.bashrc && source ~/.bashrc

3. The rest ​

Once the requirements are installed, the main installation documentation can be followed, from step "3. Activation".

Last updated: