# weeWX: Installation on Debian-based systems

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

## Configure apt

Tell apt where to find the weeWX releases. This only has to be done once - the first time you install weeWX.

    wget -qO - http://weewx.com/keys.html | sudo apt-key add -
    wget -qO - http://weewx.com/apt/weewx.list | sudo tee /etc/apt/sources.list.d/weewx.list

## Install

Use apt-get to install weeWX. The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to your station hardware.

    sudo apt-get update
    sudo apt-get install weewx

When you are done, weeWX will be running in the background as a daemon.

## Status

To make sure things are running properly 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. If your hardware supports hardware archiving, then how long you wait will depend on the archive interval set in your hardware.

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

## 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 apt-get remove weewx

To uninstall weeWX, removing configuration files but retaining data:

    sudo apt-get purge weewx

To remove data:

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

## Layout

The installation 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/html/weewx/
documentation: | /usr/share/doc/weewx/
examples: | /usr/share/doc/weewx/examples/
utilities: | /usr/bin/wee_*

© Copyright Tom Keffer