OpenStack in a snap!
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Pete Vander Giessen 0824a570ec Clean up tox.ini a bit 3 years ago
patches Align ovs version with Stein UCA 3 years ago
snap/hooks Clustering prototype 3 years ago
snap-overlay Clustering prototype 3 years ago
snap-wrappers Broke configuration out into a manual step. 3 years ago
tests Fix Eoan. 3 years ago
tools Clean up tox.ini a bit 3 years ago
.gitignore Added testing for control nodes 3 years ago
.gitreview Added automated testing via tox and zuul. 3 years ago
.zuul.yaml Ported and updated launch script 3 years ago Added 4 years ago Ported and updated launch script 3 years ago Update README since doc publication 3 years ago
snapcraft.yaml Fix Eoan. 3 years ago
test-requirements.txt Added testing for control nodes 3 years ago
tox.ini Clean up tox.ini a bit 3 years ago


Snap Status

MicroStack is a single-machine, snap-deployed OpenStack cloud.

Common purposes include:

  • Development and testing of OpenStack workloads
  • Continuous integration (CI)
  • IoT and appliances
  • Edge clouds (experimental)
  • Introducing new users to OpenStack

Currently provided OpenStack services are: Nova, Keystone, Glance, Horizon, and Neutron.

MicroStack is frequently updated to provide the latest stable updates of the most recent OpenStack release.

Requirements: You will need at least 2 CPUs, 8 GiB of memory, and 100 GiB of disk space.

See the full MicroStack documentation.


At this time you can install from the --beta or --edge snap channels:

sudo snap install microstack --classic --beta


Initialisation will set up databases, networks, flavors, an SSH keypair, a CirrOS image, and open ICMP/SSH security groups:

sudo microstack.init --auto

OpenStack client

The OpenStack client is bundled as microstack.openstack. For example:

microstack.openstack network list
microstack.openstack flavor list
microstack.openstack keypair list
microstack.openstack image list
microstack.openstack security group rule list

Creating an instance

To create an instance (called "awesome") based on the CirrOS image:

microstack.launch cirros --name awesome

SSH to an instance

The launch output will show you how to connect to the instance. For the CirrOS image, the user account is 'cirros'.

ssh -i ~/.ssh/id_microstack cirros@<ip-address>


The launch output will also provide information for the Horizon dashboard. Its credentials are:

username: admin
password: keystone

Customising and contributing

To customise services and settings, look in the .d directories under /var/snap/microstack/common/etc. You can add services with your package manager, or take a look at and make a code based argument for adding a service to the default list.

Reporting a bug

Please report bugs to the MicroStack project on Launchpad.