weewx: Quick Start Guide for Debian Linux

This is a guide to install weewx from DEB package on systems such as Debian, Ubuntu or Mint. The installation will result in the following layout:

configuration file: /etc/weewx/weewx.conf
skins and templates: /etc/weewx/skins
sqlite databases: /var/lib/weewx/
web pages and images: /var/lib/weewx/html

Installation must be done with root privileges.

Download

Download the package weewx-X.Y.Z-R.deb from Sourceforge.

Install

Install weewx by double-clicking the .deb file, or via command line:

sudo dpkg -i weewx-X.Y.Z-R.deb

If dpkg complains about dependency problems, use apt-get to resolve the dependencies and complete the installation:

sudo apt-get -f install

The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to the station.

Verify

After 5 minutes, open the station web page in a web browser. You should see the default weewx page with your station information and data.

file:///usr/lib/weewx/html/index.html

Status

Look in the system log for messages from weewx.

sudo tail -f /var/log/messages

Customize

To enable uploads such as Weather Underground or to customize reports, modify the configuration file /etc/weewx.conf. See the User Guide and Customization Guide for details.

weewx must be restarted for configuration file changes to take effect.

Start/Stop

The installer configures weewx to run when the computer starts up and starts weewx the first time. To start/stop weewx manually:

sudo /etc/init.d/weewx start
sudo /etc/init.d/weewx stop

Uninstall

To uninstall weewx but retain configuration files and data:

sudo dpkg -r weewx

To uninstall weewx, removing configuration files but retaining data:

sudo dpkg --purge weewx