@@ -45,12 +45,34 @@ as well as Debian and OpenSUSE.

 If you do not have a preference, Ubuntu 16.04 is the most tested, and

 will probably go the smoothest.

+Add Stack User

+--------------

+

+Devstack should be run as a non-root user with sudo enabled

+(standard logins to cloud images such as "ubuntu" or "cloud-user"

+are usually fine).

+

+You can quickly create a separate `stack` user to run DevStack with

+

+::

+

+   $ adduser stack

+

+Since this user will be making many changes to your system, it should

+have sudo privileges:

+

+::

+

+    $ echo "stack ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers

+    $ su stack

+

 Download DevStack

 -----------------

 ::

-   git clone https://git.openstack.org/openstack-dev/devstack

+   $ git clone https://git.openstack.org/openstack-dev/devstack

+   $ cd devstack

 The ``devstack`` repo contains a script that installs OpenStack and

 templates for configuration files

@@ -58,8 +80,8 @@ templates for configuration files

 Create a local.conf

 -------------------

-Create a ``local.conf`` file with 4 passwords preset

-

+Create a ``local.conf`` file with 4 passwords preset at the root of the

+devstack git repo.

 ::

    [[local|localrc]]

@@ -70,25 +92,12 @@ Create a ``local.conf`` file with 4 passwords preset

 This is the minimum required config to get started with DevStack.

-Add Stack User

-

-Devstack should be run as a non-root user with sudo enabled

-(standard logins to cloud images such as "ubuntu" or "cloud-user"

-are usually fine).

-

-You can quickly create a separate `stack` user to run DevStack with

-

-::

-

-   devstack/tools/create-stack-user.sh; su stack

-

 Start the install

 -----------------

 ::

-   cd devstack; ./stack.sh

+   ./stack.sh

 This will take a 15 - 20 minutes, largely depending on the speed of

 your internet connection. Many git trees and packages will be