# WeeWX: Installation on Redhat-based systems

This is a guide to installing WeeWX from an RPM package on systems such as Redhat, CentOS or Fedora.

## Install pre-requisites

For Redhat 8:

    sudo yum install epel-release
    sudo yum install python3-cheetah

For Redhat 7:

    sudo pip install pyserial pyusb

## Configure yum

Tell yum (or dnf) where to find the WeeWX releases. This only has to be done once - the first time you install WeeWX.

Tell your system to trust weewx.com:

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

For Redhat 8 use python3:

    curl -s http://weewx.com/yum/weewx-el8.repo | sudo tee /etc/yum.repos.d/weewx.repo

For Redhat 7 use python2:

    curl -s http://weewx.com/yum/weewx-el7.repo | sudo tee /etc/yum.repos.d/weewx.repo

## Install WeeWX

Install WeeWX using yum (or dnf). When you are done, WeeWX will be running the Simulator in the background as a daemon.

    sudo yum install weewx

## 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 yum remove 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