Skip to content

Installation on SUSE systems

This is a guide to installing WeeWX from an RPM package systems based on SUSE, such as openSUSE Leap.

WeeWX V5 requires Python 3.7 or greater, which is only available on SUSE-15 or later. For older systems, either use WeeWX V4, or install Python 3.7 then install WeeWX V5 using pip.

Configure zypper

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

  1. Tell your system to trust weewx.com:

    sudo rpm --import https://weewx.com/keys.html
    
  2. Tell zypper where to find the WeeWX repository.

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

Install

Install WeeWX using zypper. When you are done, WeeWX will be running the Simulator in the background as a daemon.

sudo zypper install weewx

Verify

After 5 minutes, copy the following and paste into a web browser:

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

You should see simulated data.

Check the system log /var/log/messages for problems.

Configure

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

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

Customize

To enable uploads or to customize reports, modify the configuration file. See the Customization Guide for instructions, and the application and skin references for all of the options.

Use any text editor, such as nano:

sudo nano /etc/weewx/weewx.conf

WeeWX must be restarted for the changes to take effect.

sudo systemctl restart weewx

Upgrade

Upgrade to the latest version like this:

sudo zypper update weewx

The upgrade process will not modify the WeeWX databases.

Unmodified files will be upgraded. If modifications have been made to the configuration, rpm will display a message about any differences between the changes and the new configuration. 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, rpm will present 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 zypper remove weewx
To delete data:

sudo rm -r /var/lib/weewx
sudo rm -r /var/www/html/weewx