Quick start guide for Debian (Ubuntu) systems

This guide is to get you quickly started using weewx on Debian systems, particularly Ubuntu. It assumes you have already downloaded the weewx tarball.

Prerequisites

Install the required libraries:

sudo apt-get install python-configobj
sudo apt-get install python-serial
sudo apt-get install python-cheetah
sudo apt-get install python-imaging
sudo apt-get install python-dev
sudo apt-get install python-pip

The last two allow the optional package pyephem to be installed:

sudo pip install pyephem

Installing

Unpack the tar ball (substitute your version for X.Y.Z) into any convenient directory where you have write permission

tar xvf weewx-X.Y.Z

Then change directory into it:

cd weewx-X.Y.Z

Then build and install:

./setup.py build
sudo ./setup.py install

This will install weewx into its default directory /home/weewx.

Configure

Edit the configuration file /home/weewx/weewx.conf. Pay particular attention to which serial port your weather station uses (option port), the archive interval (option archive_interval), and the altitude of your station (option altitude).

Then run the configuration program to configure your hardware:

/home/weewx/bin/configure.py /home/weewx/weewx.conf --configure

Running

Now you can either run the main program from the command line:

/home/weewx/bin/weewxd.py /home/weewx/weewx.conf

Or, if you prefer to run as a daemon, then do the following:

sudo cp /home/weewx/start_scripts/Debian/weewx /etc/init.d
sudo chmod +x /etc/init.d/weewx
sudo update-rc.d weewx defaults 98
sudo /etc/init.d/weewx start