Awesome Open Source
Awesome Open Source

kcli repository

Build Status Copr




This tool is meant to interact with existing virtualization providers (libvirt, KubeVirt, oVirt, OpenStack, VMware vSphere, GCP and AWS) and to easily deploy and customize VMs from cloud images.

You can also interact with those VMs (list, info, ssh, start, stop, delete, console, serialconsole, add/delete disk, add/delete nic, ...).

Furthermore, you can deploy VMs using predefined profiles, several at once using plan files or entire products for which plans were already created for you.

Refer to the documentation for more information

Quick Start

curl | bash

Deploy your first vm with:

kcli download image centos7
kcli create vm -i centos7 myvm
kcli list vm
# wait 5-10 seconds for vm to grab an ip
kcli ssh myvm
kcli delete vm

What you can do

  • Interact with all the virtualization providers using a single tool
  • Declare all your objects (VM, containers, networks, ansible playbooks, ...) in a single yaml plan file with a simple syntax
  • Customize a plan deployment using parameters and Jinja templating
  • Adjust VMs from a plan (memory, CPU, flavor, disks and NICs) to match what's defined in the plans
  • Inject all configuration with cloud-init/Ignition or the equivalent in cloud providers
  • Use profiles to launch VMs with same hardware characteristics
  • Launch a plan from an URL
  • Share your plan or use existing ones from Github repo as products
  • Use the existing plans to deploy Kubernetes, OpenShift, OpenStack, oVirt, kubevirt, ...
  • Use the existing cloud images for each distribution
  • Easily share private keys between your VMs
  • Handle dns entries for the VMs
  • Automatically subscribe your RHEL VMs
  • Get a push button notification when a vm has finished its deployment
  • Alternatively use web UI to do the same


See contributors on GitHub


Copyright 2017-2019 Karim Boumedhel

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Open an issue or join us on kcli slack channel

Mc Fly!!!


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (54,523
kubernetes (1,772
aws (1,102
gcp (133
openshift (104
openstack (58
libvirt (31
vsphere (24