Files
weewx/docs_src/quickstarts/suse.md
2023-06-07 09:45:52 -04:00

93 lines
2.0 KiB
Markdown

# 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 SUSE 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:
```shell
sudo rpm --import https://weewx.com/keys.html
```
2. Tell `zypper` where to find the WeeWX repository.
```shell
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.
```shell
# Stop the daemon:
sudo systemctl stop weewx
# Reconfigure to use your hardware:
sudo weectl station reconfigure
# Remove 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
`/etc/weewx/weewx.conf`. See the [*User Guide*](../../usersguide) and
[*Customization Guide*](../../custom) for details.
WeeWX must be restarted for configuration file changes to take effect.
```shell
sudo systemctl restart weewx
```
## Uninstall
To uninstall WeeWX, removing configuration files but retaining data:
```shell
sudo zypper remove weewx
```
To remove data:
```shell
sudo rm -r /var/lib/weewx
sudo rm -r /var/www/html/weewx
```