2.1 KiB
Running WeeWX
WeeWX can be run either directly, or as a daemon. When first trying WeeWX, it is best to run it directly because you will be able to see sensor output and diagnostics, as well as log messages. Once everything is working properly, run it as a daemon.
Running directly
To run WeeWX directly, invoke the main program, weewxd.
weewxd
!!! note
Depending on device permissions, you may need root permissions to
communicate with the station hardware. If this is the case, use sudo:
shell sudo weewxd
!!! note
If your configuration file is named something other than `weewx.conf`, or
if it is in a non-standard place, then you will have to specify it
explicitly on the command line. For example:
```
weewxd --config=/some/path/to/weewx.conf
```
If your weather station has a data logger, the program will start by downloading any data stored in the logger into the archive database. For some stations, such as the Davis Vantage with a couple of thousand records, this could take a minute or two.
WeeWX will then start monitoring live sensor data (also referred to as 'LOOP' data), printing a short version of the received data on standard output, about once every two seconds for a Vantage station, or considerably longer for some other stations.
Running as a daemon
For unattended operations it is best to have WeeWX run as a daemon, so that it is started automatically when the computer is rebooted.
If you installed WeeWX from DEB or RPM package, this is done automatically; the installer finishes with WeeWX running in the background.
For a pip install, you will have to do this yourself. See the section Run as a daemon in the pip quick start guide.
When weewxd runs in the background, you will not see sensor data or any other
indication that it is running. However, there are several approaches you can
take to see what's happening:
- Use your system's status tools to monitor its state;
- Look at any generated reports; and
- Look at the logs.