# weeWX: Installation on SuSE-based systems

This is a guide to installing weeWX from an RPM package on systems such as SuSE or OpenSUSE.

## Download

Download the SUSE RPM package from weewx.com/downloads. It will have a name similar to weewx-X.Y.Z-R.suse.noarch.rpm.

## Install

Install pre-requisites:

    sudo zypper install python-configobj
    sudo zypper install python-cheetah
    sudo zypper install python-imaging
    sudo zypper install python-serial
    sudo zypper install python-usb

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

    sudo rpm -i weewx-X.Y.Z-R.rpm

If you see errors about untrusted signature, or MISSING KEYS, you can either install the weewx GPG keys:

    sudo rpm --import http://weewx.com/keys.html

or tell rpm to ignore the signature:

    sudo rpm -i --nosignature weewx-X.Y.Z-R.rpm

## Status

Look in the system log for messages from weeWX.

    sudo tail -f /var/log/messages

## Verify

After 5 minutes, open the station web page in a web browser. You should see generic 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

## Configure

The default installation uses Simulator as the station_type. To use real hardware, stop weeWX, change to the actual station type and station parameters, delete the simulation data, then restart weeWX:

    sudo /etc/init.d/weewx stop
    sudo wee_config --reconfigure
    sudo rm /var/lib/weewx/weewx.sdb
    sudo /etc/init.d/weewx start

## Start/Stop

To start/stop weeWX:

    sudo /etc/init.d/weewx start
    sudo /etc/init.d/weewx stop

## 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.

## Uninstall

To uninstall weeWX, removing configuration files but retaining data:

    sudo rpm -e 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-x.y.z/
examples: | /usr/share/doc/weewx/examples/
utilities: | /usr/bin/wee_*

© Copyright Tom Keffer