DevStack - an OpenStack Community Production

A documented shell script to build complete OpenStack development environments.

Created by Rackspace Cloud Builders, Maintained by the OpenStack developer community.

  1. Setup a fresh Ubuntu Precise (12.04) or Fedora 16 installation.
  2. Clone devstack from devstack.
    git clone https://github.com/openstack-dev/devstack.git
  3. Deploy your OpenStack Cloud
    cd devstack && ./stack.sh
 
  1. Install Ubuntu 12.04 (Precise) or Fedora 16

    In order to correctly install all the dependencies, we assume a minimal version of Ubuntu or Fedora to make it as easy as possible. OpenStack runs and is packaged on other flavors of Linux such as OpenSUSE and Debian. We recommend using a minimal install of Ubuntu or Fedora server in a VM if this is your first time.

  2. Download DevStack

    git clone git://github.com/openstack-dev/devstack.git

    The devstack repo contains a script that installs openstack and templates for configuration files

  3. Start the install

    cd devstack; ./stack.sh

    It takes a few minutes, we recommend reading the script while it is building.

OpenStack on VMs

Title Description Link
Virtual Machine Run OpenStack in a VM. The VMs launched in your cloud will be slow as they are running in QEMU (emulation), but it is useful if you don't have spare hardware laying around. Read »
1 Guide

What is this?

These guides tell you how to virtualize your OpenStack cloud in virtual machines. This means that you can get started without having to purchase any hardware.

OpenStack on Hardware

Title Description Link
All-In-One Run OpenStack on dedicated hardware to get real performance in your VMs. This can include a server-class machine or a laptop at home. Read »
Multi-Node + VLANs Setup a multi-node cluster with dedicated VLANs for VMs & Management. Read »
Stack-in-a-Box Run OpenStack from a RAM disk to give it a spin without touching your existing OS installation. Includes PXE and USB boot methods. Read »
3 Guides

What is this?

These guides tell you how to deploy a development environment on real hardware. Guides range from running OpenStack on a single laptop to running a multi-node deployment on datacenter hardware.

Overview

An overview of DevStack goals and priorities.

Recent Changes

An incomplete summary of recent changes to DevStack.

FAQ

The DevStack FAQ.



Scripts Generated documentation of DevStack scripts.

Filename Link
stack.sh Read »
functions Read »
lib/baremetal Read »
lib/ceilometer Read »
lib/cinder Read »
lib/database Read »
lib/glance Read »
lib/heat Read »
lib/horizon Read »
lib/keystone Read »
lib/ldap Read »
lib/nova Read »
lib/quantum Read »
lib/rpc_backend Read »
lib/swift Read »
lib/tempest Read »
lib/tls Read »
unstack.sh Read »
exercise.sh Read »
exercises/aggregates.sh Read »
exercises/boot_from_volume.sh Read »
exercises/bundle.sh Read »
exercises/client-args.sh Read »
exercises/client-env.sh Read »
exercises/euca.sh Read »
exercises/floating_ips.sh Read »
exercises/horizon.sh Read »
exercises/quantum-adv-test.sh Read »
exercises/sec_groups.sh Read »
exercises/swift.sh Read »
exercises/volumes.sh Read »
tools/info.sh Read »
tools/install_prereqs.sh Read »
tools/upload_image.sh Read »
34 bash scripts

Configuration Setting the table

Filename Link
openrc Read »
stackrc Read »
localrc Read »
exerciserc Read »
eucarc Read »
5 configuration files

Samples Generated documentation of DevStack sample files.

Filename Link
local.sh Read »
localrc Read »
2 sample files