This section describes the location and contents of Zotonic’s global
zotonic.config. There’s also
Config file locations¶
Zotonic depends on two global config files, called
erlang.config. On startup, Zotonic looks in the following
places for these files:
(nodename) is the name of the Zotonic Erlang node, which
zotonic001 (and can be set with
variable). Using the node name in the configuration path comes in
handy when you want to run multiple Zotonic instances simultaneously.
(version) is the minor version number of Zotonic, e.g.
way, you can have separate configuration files for different versions of Zotonic
which are running simultaneously.
For example, if the version is 1.2 then
(version) will be
(major-version) will be
If the Zotonic startup script finds a config file in one of the directories, it stops looking, so files in the other directories are ignored.
In the course of Zotonic starting up, it will print the locations of the global config files that it is using:
17:03:54.766 [info] Zotonic started 17:03:54.766 [info] =============== 17:03:54.766 [info] Config files used: 17:03:54.768 [info] - /home/user/.zotonic/1.0/erlang.config 17:03:54.768 [info] - /home/user/.zotonic/zotonic001/zotonic.config
After installed for the first time, the
~/.zotonic/zotonic.config file is well
annoted with comments about what each setting does. When in doubt,
consult the stock
apps/zotonic_launcher/priv/config/zotonic.config.in file for
explanation about all config settings.
zotonic.config file you will find the password for the
zotonic_status site where you can manage the server.
Zotonic configurations can also be fetched in the Erlang shell.
For example, view the
Zotonic keeps sites and modules that are external to Zotonic, e.g. installed by website developers, outside the Zotonic source tree.
The directory under which Zotonic expects to find all sites is called
the User sites directory. This is configured with the config
user_sites_dir. This directory defaults to
_checkouts, relative to Zotonic’s installation directory.
The directory under which Zotonic expects to find all external
modules, e.g. those installed with
zotonic modules install
mod_...., is called the User modules directory. This is configured
with the config parameter
user_modules_dir. This directory
_checkouts, relative to Zotonic’s installation