Kolla provides production-ready containers and deployment tools for operating OpenStack clouds
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.
Jenkins 40e768ec2a Merge "Add register to upgrade.yml to create correct endpoint" 6 years ago
ansible Merge "Add register to upgrade.yml to create correct endpoint" 6 years ago
demos Extension .md is changed to .rst 7 years ago
dev/vagrant Update "which" command to "type" 6 years ago
doc Merge "Clean up TODOs from live documentation" 6 years ago
docker Merge "Fix the failure to launch instance when enabled Ceph" 6 years ago
etc integrate gnocchi with ceilometer 6 years ago
kolla Merge "Deprecate Fedora based Docker images" 6 years ago
releasenotes Merge "Heka deprecation" 6 years ago
specs Fix inconsistencies in git url 6 years ago
tests Changed docker_restart_policy to unless-stopped 6 years ago
tools Choose node with largest seqno number for mariadb recovery 6 years ago
.gitignore Fix the prechecks for the ansible version 6 years ago
.gitreview Update .gitreview for project rename 7 years ago
.testr.conf Merge "Revert "Capture the log in default"" 6 years ago
LICENSE Add ASL license 8 years ago
README.rst Added Barbican in the list of services deployed by kolla 6 years ago
bindep.txt Add more packages in bindep.txt 6 years ago
loc loc fails with recent removal of heat dev env 6 years ago
requirements.txt Add netaddr to requirements file 6 years ago
setup.cfg Added missing cleanup-images in setup.cfg 6 years ago
setup.py Updated from global requirements 6 years ago
test-requirements.txt Updated from global requirements 6 years ago
tox.ini Merge "Add support to use pdb with tox" 6 years ago


Kolla Overview

The Kolla project is a member of the OpenStack Big Tent Governance.

Kolla's mission statement is:

To provide production-ready containers and deployment tools for operating
OpenStack clouds.

Kolla provides Docker containers and Ansible playbooks to meet Kolla's mission.

Kolla is highly opinionated out of the box, but allows for complete customization. This permits operators with little experience to deploy OpenStack quickly and as experience grows modify the OpenStack configuration to suit the operator's exact requirements.

Getting Started

Learn about Kolla by reading the documentation online docs.openstack.org.

Get started by reading the Developer Quickstart.

Docker images

The Docker images are built by the Kolla project maintainers. A detailed process for contributing to the images can be found in the image building guide.

The Kolla developers build images in the kolla namespace for every tagged release and implement an Ansible roles for many but not all of them.

You can view the available images on Docker Hub or with the Docker CLI:

$ sudo docker search kolla

OpenStack services

Kolla provides images to deploy the following OpenStack projects:

Infrastructure components

Kolla provides images to deploy the following infrastructure components:


  • ansible - Contains Ansible playbooks to deploy Kolla in Docker containers.
  • demos - Contains a few demos to use with Kolla.
  • dev/vagrant - Contains a vagrant VirtualBox/Libvirt based development environment.
  • doc - Contains documentation.
  • docker - Contains jinja2 templates for the docker build system.
  • etc - Contains a reference etc directory structure which requires configuration of a small number of configuration variables to achieve a working All-in-One (AIO) deployment.
  • tests - Contains functional testing tools.
  • tools - Contains tools for interacting with Kolla.
  • specs - Contains the Kolla communities key arguments about architectural shifts in the code base.

Getting Involved

Need a feature? Find a bug? Let us know! Contributions are much appreciated and should follow the standard Gerrit workflow.

  • We communicate using the #openstack-kolla irc channel.
  • File bugs, blueprints, track releases, etc on Launchpad.
  • Attend weekly meetings.
  • Contribute code.


Check out who's contributing code and contributing reviews.