`DevStack </>`__

-  `Overview <../overview.html>`__
-  `Changes <../changes.html>`__
-  `FAQ <../faq.html>`__
-  `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__
-  `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__

Stack-in-a-Box: Try before you mkfs
===================================

Run DevStack from a RAM disk to give it a whirl before making the
commitment to install it. We'll cover booting from a USB drive or over
the network via PXE. We'll even thow in configuring a home router to
handle the PXE boot. You will need a minimum of 3GB for both of these
configurations as the RAM disk itself is 2GB.

Prerequisites Hardware
----------------------

USB Boot
~~~~~~~~

`This guide <usb-boot.html>`__ covers the creation of a bootable USB
drive. Your computer BIOS must support booting from USB.

PXE Boot
~~~~~~~~

`This guide <pxe-boot.html>`__ covers the installation of OpenWRT on a
home router and configuring it as a PXE server, plus the creation of the
boot images and PXE support files.

Installation bit blasting
-------------------------

Install DevStack
~~~~~~~~~~~~~~~~

Grab the latest version of DevStack via https:

::

    sudo apt-get install git -y
    git clone https://git.openstack.org/openstack-dev/devstack
    cd devstack

Prepare the Boot RAMdisk
~~~~~~~~~~~~~~~~~~~~~~~~

Pick your boot method and follow the guide to prepare to build the RAM
disk and set up the boot process:

-  `USB boot <usb-boot.html>`__
-  `PXE boot <pxe-boot.html>`__

Fire It Up
~~~~~~~~~~

-  Boot the computer into the RAM disk. The details will vary from
   machine to machine but most BIOSes have a method to select the boot
   device, often by pressing F12 during POST.
-  Select 'DevStack' from the Boot Menu.
-  Log in with the 'stack' user and 'pass' password.
-  Create ``devstack/localrc`` if you wish to change any of the
   configuration variables. You will probably want to at least set the
   admin login password to something memorable rather than the default
   20 random characters:

   ::

       ADMIN_PASSWORD=openstack

-  Fire up OpenStack!

   ::

       ./run.sh

-  See the processes running in screen:

   ::

       screen -x

-  Connect to the dashboard at ``http://<ip-address>/``