Skip to main content

Spin ManageIQ/CFME Appliance locally.

Project description


  1. Virtualization:

    • Fedora

      sudo dnf install @virtualization
      systemctl start libvirtd
      systemctl enable libvirtd

      If you want optional packages

      dnf group install --with-optional virtualization
    • Ubuntu

      sudo apt-get install qemu-kvm
  2. Devel Packages:

    sudo dnf install libvirt-devel python-devel python3-devel


  • pip

    pip install miqbox --user
  • source

    python install --user


  • libvirt: Polkit error

  • To prevent libvirt from asking root password:

    • Add libvirt group (It may be present by default)

      sudo groupadd libvirt
    • Add not root user as member

      sudo usermod -a -G libvirt <username>
    • Add Polkit rule for libvirt:

      vim /etc/polkit-1/rules.d/80-libvirt.rules
      polkit.addRule(function(action, subject) {
      if ( == "org.libvirt.unix.manage"
          && subject.local
          && subject.isInGroup("libvirt")) {
      return polkit.Result.YES;


  • Help available with MiqBox

     Usage: miqbox [OPTIONS] COMMAND [ARGS]...
       Spin ManageIQ/CFME Appliance locally with Virtualization.
       --version  Show the version and exit.
       --help     Show this message and exit.
       config     Configure MiqBox
       create     Create Appliance
       evmserver  Restart Miq/CFME Server
       images     Check available images
       kill       Kill Appliance
       pull       Download Image
       rmi        Remove local Images
       start      Start Appliance
       status     Appliance Status
       stop       Stop Appliance


  • Fork the repository on GitHub and make some changes. Make sure to add yourself to AUTHORS.

  • Install the in development mode

    pip install -r requirements-dev.txt
    pip install -e .
  • Send pull requests and bugs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for miqbox, version 1.5
Filename, size File type Python version Upload date Hashes
Filename, size miqbox-1.5-py3-none-any.whl (15.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size miqbox-1.5.tar.gz (16.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page