weewx: Installation on Debian-based systems

This is a guide to installing weewx from a DEB package on Debian-based systems, including Ubuntu and Mint.

Download

Download the package weewx_X.Y.Z-R_all.deb from Sourceforge.

Install

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

sudo dpkg -i weewx_X.Y.Z-R_all.deb
  

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

sudo apt-get update
sudo apt-get -f install

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

Verify

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

    file:///var/www/weewx/index.html
  

Status

Look in the system log for messages from weewx.

sudo tail -f /var/log/syslog

Customize

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

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

Start/Stop

To start/stop weewx:

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

To remove data:

sudo rm -r /var/lib/weewx sudo rm -r /var/www/weewx

Layout

If you followed the installation guide above, then it will result in the following layout:

executable: /usr/bin/weewxd
configuration file: /etc/weewx/weewx.conf
skins and templates: /etc/weewx/skins
sqlite databases: /var/lib/weewx/
generated web pages and images: /var/www/weewx/
documentation: /usr/share/doc/weewx/