Configuration Settings

Bitcoin Server is highly configurable. Configuration settings are centralized in a single configuration file. All configuration changes require process restart to take effect.

Specifying a Configuration File

The path to the configuration settings file is specified by the --config command line option, the BS_CONFIG environment variable, or by default as follows:

• Linux/OSX (prefix): <prefix>/etc/libbitcoin/bs.cfg
• Linux/OSX (default): /usr/local/etc/libbitcoin/bs.cfg
• Windows: %ProgramData%\libbitcoin\bs.cfg

The Windows directory is hidden by default. If the specified file is not found default values are loaded. If the file contains invalid settings an error is returned via STDERR. If any setting is not specified its default is loaded.

BS uses Boost's program_options library to bind configuration settings. The implementation supports a two level hierarchy of settings using "sections" to group settings, similar to an .ini file.

Default Configuration Settings

For convenience, the bs.cfg file is populated with all default settings values.

Exporting Settings

The --settings command line option emits the definitions for all configuration settings.