Installation on Redhat systems¶

This is a guide to installing WeeWX from an RPM package on systems based on Redhat, including Fedora, CentOS, or Rocky.

WeeWX V5 requires Python 3.6 or greater, which is only available as a Redhat package, with required modules, on Redhat 8 or later. For older systems, install Python 3 then install WeeWX using pip.

Configure yum¶

The first time you install WeeWX, you must configure yum so that it will trust weewx.com, and know where to find the WeeWX releases.

1. Configure yum to use epel-release, since some of the Python modules required by WeeWX are in that respository.

   sudo dnf config-manager --set-enabled crb
   sudo dnf -y install epel-release
   

2. Tell your system to trust weewx.com:

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

3. Tell yum where to find the WeeWX repository.

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

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

curl -s https://weewx.com/yum/weewx-el9.repo | \
    sudo tee /etc/yum.repos.d/weewx.repo

Install¶

Install WeeWX using yum or dnf. When you are done, WeeWX will be running the Simulator in the background.

sudo yum install weewx

Verify¶

After 5 minutes, copy the following and paste into a web browser. You should see simulated data.

/var/www/html/weewx/index.html

If things are not working as you think they should, check the status:

sudo systemctl status weewx

sudo journalctl -u weewx

Configure¶

To switch from the Simulator to real hardware, reconfigure the driver.

# Stop the daemon
sudo systemctl stop weewx
# Reconfigure to use your hardware
weectl station reconfigure
# Delete the old database
rm /var/lib/weewx/weewx.sdb
# Start the daemon:
sudo systemctl start weewx

Customize¶

To enable uploads, or to enable other reports, modify the configuration file /etc/weewx/weewx.conf using any text editor such as nano:

nano /etc/weewx/weewx.conf

The reference Application options contains an extensive list of the configuration options, with explanations for what they do. For more advanced customization, see the Customization Guide, as well as the reference Skin options.

To install new skins, drivers, or other extensions, use the extension utility.

WeeWX must be restarted for the changes to take effect.

sudo systemctl restart weewx

Upgrade¶

Upgrade to the latest version like this:

sudo yum update weewx

The upgrade process will only upgrade the WeeWX software; it does not modify the configuration file, database, or any extensions you may have installed.

If modifications have been made to the configuration file or the skins that come with WeeWX, you will see a message about any differences between the modified files and the new files. Any new changes from the upgrade will be noted as files with a .rpmnew extension, and the modified files will be left untouched.

For example, if /etc/weewx/weewx.conf was modified, you will see a message something like this:

warning: /etc/weewx/weewx.conf created as /etc/weewx/weewx.conf.rpmnew

Uninstall¶

To uninstall WeeWX, deleting configuration files but retaining data:

sudo yum remove weewx

When you use yum to uninstall WeeWX, it does not touch WeeWX data, logs, or any changes you might have made to the WeeWX configuration. It also leaves the weewx user, since data and configuration files were owned by that user. To remove every trace of WeeWX:

sudo yum remove weewx
sudo rm -r /var/www/html/weewx
sudo rm -r /var/lib/weewx
sudo rm -r /etc/weewx
sudo rm /etc/default/weewx
sudo gpasswd -d $USER weewx
sudo userdel weewx
sudo groupdel weewx