# Vespa environment variables

Vespa configuration is set in application packages. Some configuration is used to bootstrap nodes - this is set in environment variables. Environment variables are only read at startup.

\$VESPA_HOME/conf/vespa/default-env.txt is read in Vespa start scripts - use this to modify variables. Each line has the format action variablename value where the items are:
action One of fallback, override, or unset. fallback sets the variable if it is unset (or empty). override set the value regardless. unset unsets the variable. The name of the variable, e.g. VESPA_CONFIGSERVERS The rest of the line is the variable's value.

Environment variables:

VESPA_CONFIGSERVERS A comma-separated list of hosts to run configservers (default localhost). Should always be set to the same value on all hosts in a multi-host setup. The port number where REST apis will run, default 8080. This isn't strictly needed, as the port number can be set for each HTTP server in services.xml, but with a big application it can be easier to set the default port number just once. Also note that this needs to be set when starting the configserver, since the REST api implementation gets its port number from there.