localrc is the old file used to configure DevStack.
It is deprecated and has been replaced by
DevStack will continue to use localrc if it is
present and ignore the localrc section in
Remove localrc to switch to using the new file.
OpenStack Training Videos
Play Training Videos
local.conf is a user-maintained setings file that is
sourced in stackrc.
It contains a section that replaces the historical
local.conf resides in the root DevStack directory
like the old localrc file.
It is a modified INI format file that introduces a
meta-section header to carry additional
information regarding the configuration files to be
A specific meta-section local|localrc is used to
provide a default localrc file.
This allows all custom settings for DevStack to be
contained in a single file.If localrc exists it will be
used instead to preserve backward-compatibility.
1) pre-set the passwords to prevent interactive
If the *_PASSWORD variables are not set here you will be prompted to enter values for
them by stack.sh.
2) Move network ranges away from the local
The network ranges must not overlap with any networks in use on the host.
3) Set the host IP if detection is unreliable
HOST_IP is normally detected on the first run of stack.sh but often is indeterminate on
later runs due to the IP being moved from an Ethernet interface to a bridge on the host.
Setting it here also makes it available for openrc to set OS_AUTH_URL. HOST_IP is not
set by default.
5) Specify the libraries to be installed from Git
By default devstack installs OpenStack server components from git, however it installs
client libraries from released versions on pypi. This is appropriate if you are working on
server development, but if you want to see how an unreleased version of the client affects
the system you can have devstack install it from upstream, or from local git trees.
Multiple libraries can be specified as a comma separated list.
6) Enable Logging
By default stack.sh output is only written to the console where is runs. It can be sent to a
file in addition to the console by setting LOGFILE to the fully-qualified name of the
destination log file. A timestamp will be appended to the given filename for each run of
7) Enable Syslog
Logging all services to a single syslog can be convenient. Enable syslogging by setting
SYSLOG to True. If the destination log host is not localhost SYSLOG_HOST and
SYSLOG_PORT can be used to direct the message stream to the log host.
8) A clean installation of OpenStack every time
you run stack.sh
By default stack.sh only clones the project repos if they do not exist in $DEST. stack.sh
will freshen each repo on each run if RECLONE is set to yes.