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.

Status

Look in the system log for messages from weewx.

sudo tail -f /var/log/syslog

Verify

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

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

If your hardware supports hardware archiving, then how long you wait will depend on the archive interval set in your hardware.

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/