Quick start guide for Debian (Ubuntu) systems

This guide is to get you quickly started using weewx on Debian systems, particularly Ubuntu.

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

If you wish to install the optional package pyephem for extended almanac information, then add:

sudo apt-get install python-dev
sudo apt-get install python-pip
sudo pip install pyephem

Installing

Download the tar ball from the weewx homepage on Sourceforge, then unpack (substitute your version for X.Y.Z) into any convenient directory where you have write permission

tar xvf weewx-X.Y.Z

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