Installation

Using Install Script (Ubuntu 20.04 only)

The install script for can be found here.

This will install Koble and the dependencies for both the Podman and UML driver.

wget https://github.com/b177y/koble/releases/download/v0.1/install.sh

# manually inspect installer, check code is trusted before executing
less install.sh

bash install.sh

Manual Installation

This has not been tested and is not guaranteed to work on all distros. Currently binaries are only available for linux amd64 architectures.

If you want to install on a distro other than Ubuntu 20.04, you will need the following:

  • Download the koble binary to ~/.local/bin/koble and make sure "~/.local/bin" is in your PATH. You will need to make this executable (chmod +x ~/.local/bin/koble) It is recommended to add koble completion bash to your bashrc or koble completion zsh to your zshrc if you use zsh.

  • Install Podman (recommended version > 3.4)

  • For the User Mode Linux driver:

    • Download the UML filesystem and extract to ~/.local/share/uml/images/koble-fs

    • Download the UML kernel and extract to ~/.local/share/uml/kernel/koble-kernel

Finally, set up your system to allow rootless containers to run, and setup Podman:

sudo sysctl kernel.unprivileged_userns_clone=1
sudo touch /etc/subuid /etc/subgid
sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 $USER
systemctl --user enable --now podman.socket
podman pull docker.io/b177y/uml-runner
podman pull docker.io/b177y/koble-deb