# General options

The options declared at the top are not part of any section.

#### ==debug==

Set to `1` to have the program perform extra debug checks, as well as emit extra
information in the log file. This is strongly recommended if you are having
trouble. Set to `2` for even more information. Otherwise, set to `0`. Default is
`0` (no debug).

#### ==log_success==

If set to `true`, the default will be to log a successful operation (for
example, the completion of a report, or uploading to the Weather Underground,
etc.) to the system log. Default is `true`.

#### ==log_failure==

If set to `true`, the default will be to log an unsuccessful operation (for
example, failure to generate a report, or failure to upload to the Weather
Underground, etc.) to the system log. Default is `true`.

#### WEEWX_ROOT

`WEEWX_ROOT` is the path to the root directory of the station data area. 

If not specified, its default value is the directory of the configuration file.
For example, if the configuration file is `/etc/weewx/weewx.conf`, then the
default value will be `/etc/weewx`.

If a relative path is specified, then it will be relative to the directory of
the configuration file. 

The average user rarely needs to specify a value.


#### USER_ROOT

The location of the user package, relative to `WEEWX_ROOT`. WeeWX will look for
any user-installed extensions in this directory. Default is `bin/user`.

#### socket_timeout

Set to how long to wait in seconds before declaring a socket time out. This is
used by many services such as FTP, or the uploaders. Twenty (20) seconds is
reasonable. Default is `20`.

#### gc_interval

Set to how often garbage collection should be performed in seconds by the Python
runtime engine. Default is every `10800` (3 hours).

#### loop_on_init

Normally, if a hardware driver fails to load, WeeWX will exit, on the assumption
that there is likely a configuration problem and so retries are useless.
However, in some cases, drivers can fail to load for intermittent reasons, such
as a network failure. In these cases, it may be useful to have WeeWX do a retry.
Setting this option to `true` will cause WeeWX to keep retrying indefinitely.
Default is `false`.

#### retry_wait

If a retry is called for, how long to wait in seconds. Default is `60`.