Installation on SUSE-based systems¶

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

Compatible operating system versions¶

WeeWX V5.x requires Python v3.7 or greater, which is only available on operating systems based on SUSE-15 or later. A package installer for Python 2 is not available.

It is recommended that users of older operating systems either use WeeWX V4.x (unsupported), or install Python 3.7 or greater on their system.

Configure zypper¶

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

Tell your system to trust weewx.com:

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

Define the repo:

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

Install¶

Having configured zypper, you can now use it to install WeeWX. The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to your station hardware.

sudo zypper install weewx

Verify¶

After about 5 minutes (the exact length of time depends on your archive interval), cut and paste the following into your web browser:

/var/www/html/index.html

You should see your station information and data.

You may also want to check your system log for any problems.

Configure¶

If you chose the simulator as your station type, then at some point you will probably want to switch to using real hardware. Here's how to reconfigure.

sudo /etc/init.d/weewx stop
# Reconfigure to use your hardware:
sudo weectl station reconfigure
# Remove the old database:
sudo rm /var/lib/weewx/weewx.sdb
# Restart:
sudo /etc/init.d/weewx start

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 zypper remove weewx

To remove data:

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