1
0
Fork
You've already forked kcli-toolbox
0
A fedora-toolbox with karmab/kcli
  • Dockerfile 100%
2026年06月08日 21:22:06 +02:00
.forgejo/workflows Fix: Wrong cron line 2026年06月02日 09:49:35 +02:00
Containerfile Switch vim-minimal with vim-enhanced 2026年05月25日 23:10:42 +02:00
LICENSE Add GPLv3 license 2026年05月17日 13:31:02 +02:00
README.md Add: Add Q&A section with solution for encountered first issue. 2026年06月08日 21:22:06 +02:00

kcli-toolbox

karmab/kcli is a command line tool meant to interact with existing virtualization providers (libvirt, KubeVirt, oVirt, OpenStack, VMware vSphere, AWS, Azure, GCP, IBM cloud and Hcloud) and to easily deploy and customize VMs from cloud images.

Toolbx is a tool for Linux, which allows the use of interactive command line environments for software development and troubleshooting the host operating system, without having to install software on the host.

And kcli-toolbox is a custom toolbox container that comes with kcli pre-installed.

Motivation

The container install guide shows a lot of options for tweaking and suggests to set some aliases. I don't like to do that on all hosts where I might like to use kcli.

Further the build for epel-9 was broken at the time I tried so I didn't get the latest release version as RPM package either. The solution for me was to build a custom toolbox container with fedora-toolbox:44 as a base image.

Quick Start

To use this toolbox container you need to install toolbox or toolbx using the package manager of your Linux distribution. Once you did that, run the following steps:

  1. toolbox create --image quay.io/rhn-support-jkastnin/kcli-toolbox:latest kcli
  2. toolbox enter kcli

Further reading

Problems?

If you encounter any problem that you cannot solve by reading the documentation provided above, please raise your issue with the issue tracker of the projects involved here.

I cannot support kcli or the fedora-toolbox:44 base image. If you have any trouble pulling the kcli-toolbox image or found any problem with this image, please feel free to create an issue in this repository.

Q&A

Question 1: What causes the following error when I try to download a rhel10, rhel9 or rhel8 image?

~]$ kcli download image rhel10
Opening url https://access.redhat.com/downloads/content/479/ver=/rhel---10 for you to grab complete url for rhel10 kvm guest image
Copy Url:
gio: https://access.redhat.com/downloads/content/479/ver=/rhel---10: Failed to find default application for content type ‘text/html’
Missing proper url.Leaving...

Answer 1: Kcli needs to open a browser where you need to copy&paste the download URL for the desired image to the CLI. As kci-toolbox does not contain a browser this step fails with the above error message.

Recommended solution 1:

Run again and paste the CDN URL at the prompt (do not press Enter empty):

kcli download image rhel10
# At "Copy Url:" paste the full cdn.redhat.com qcow2 URL

You can ignore the gio error if you already have the URL from a browser on the host.