OpenStack in a snap!
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Billy Olsen f96a0f8123 Revert django debug setting back to False
Commit 4123da81 changed the innocuous DEBUG setting from True to False
in the django local_settings for horizon. Unfortunately, the DEBUG flag
is used by django in order to determine (among other things) whether or
not to serve static files.

This change reverts the DEBUG setting from False to True and adds
breadcrumb comments for future travelers in oder to prevent this in the

Closes-Bug: 1957696

Change-Id: I0bb57ce3f6b3ba124844267f2d9ae6ca35922d8c
1 year ago
checks Added Filebeat, NRPE and Telegraf to Microstack 3 years ago
patches Use focal/core20/Ussuri/OVN & enable confinement 3 years ago
snap/hooks Remove legacy post-refresh hook code 2 years ago
snap-overlay Revert django debug setting back to False 1 year ago
snap-wrappers Skip hostname checks and drop IP-based ACLs 3 years ago
tests Use microstack-support interface, drop devmode 2 years ago
tools Merge "Use microstack-support interface, drop devmode" 2 years ago
.gitignore Strict confinement (devmode) 3 years ago
.gitreview Added automated testing via tox and zuul. 4 years ago
.zuul.yaml Migrate functional testing to third-parth CI 2 years ago Updated "Building MicroStack" section of 4 years ago Add TLS OpenStack API endpoints 2 years ago Add command to README for retrieving admin password 3 years ago
filebeat.pgp.key Added Filebeat, NRPE and Telegraf to Microstack 3 years ago
osci.yaml Remove timeout overrides 2 years ago
snapcraft.yaml Merge "Use microstack-support interface, drop devmode" 2 years ago
telegraf.pgp.key Added Filebeat, NRPE and Telegraf to Microstack 3 years ago
test-requirements.txt Rework the test framework & the clustering test 2 years ago
tox.ini Move volume tests to experimental pipeline 2 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

The edge channel is moving toward a strictly confined snap. At this time, it must be installed in devmode:

sudo snap install microstack --devmode --edge


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. The username is 'admin' and the password can be obtained in this way:

sudo snap get microstack config.credentials.keystone-password

Removing MicroStack

To remove MicroStack, run:

sudo microstack.remove --auto

This will clean up the Open vSwitch bridge device and uninstall MicroStack. If you remove MicroStack with the snap remove command instead, don't worry -- the Open vSwitch bridge will disappear the next time that you reboot your system.

Note that you can pass any arguments that you'd pass to the snap remove command to microstack.remove. To purge the snap, for example, run:

sudo microstack.remove --auto --purge

LMA stack

Filebeat, Telegraf and NRPE are bundled as the snap systemd services.

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.