Installation on Debian systems¶
This is a guide to installing WeeWX from a DEB package on systems based on Debian, including Ubuntu, Mint, and Raspberry Pi OS.
WeeWX V5 requires Python 3.7 or greater, which is only available on Debian 10 or later. For older systems, either use WeeWX V4, or install Python 3.7 then install WeeWX V5 using pip.
Configure apt
¶
The first time you install WeeWX, you must configure apt
so that it will
trust weewx.com, and know where to find the WeeWX releases.
-
Tell your system to trust weewx.com.
wget -qO - https://weewx.com/keys.html | \ sudo gpg --dearmor --output /etc/apt/trusted.gpg.d/weewx.gpg
-
Tell
apt
where to find the WeeWX repository.echo "deb [arch=all] https://weewx.com/apt/python3 buster main" | \ sudo tee /etc/apt/sources.list.d/weewx.list
If you encounter errors, please consult the FAQ.
Install¶
Use apt
to install WeeWX. The installer will prompt for a location,
latitude/longitude, altitude, station type, and parameters specific to your
station hardware. When you are done, WeeWX will be running in the background
as a daemon.
sudo apt update
sudo apt install weewx
Verify¶
After about 5 minutes (the exact length of time depends on your archive interval), copy the following and paste into a web browser:
/var/www/html/weewx/index.html
You should see your station information and data.
Check the system log /var/log/syslog
for 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. This is how to reconfigure.
# 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.
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
See the User Guide and Customization Guide for details.
Upgrade¶
Upgrade to the latest version like this:
sudo apt update
sudo apt install weewx
The upgrade process will not modify the WeeWX databases.
Unmodified files will be upgraded. If modifications have been made to the WeeWX configuration, you will be prompted whether you want to keep the existing configuration or accept the new configuration. Either way, a copy of the option you did not choose will be saved.
For example, if /etc/weewx/weewx.conf
was modified, you will see a message
something like this:
Configuration file `/etc/weewx/weewx.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : start a shell to examine the situation
The default action is to keep your current version.
*** weewx.conf (Y/I/N/O/D/Z) [default=N] ?
Choosing Y
or I
(install the new version) will place your old
configuration in /etc/weewx/weewx.conf.dpkg-old
, where it can be
compared with the new version in /etc/weewx/weewx.conf
.
Choosing N
or O
(keep the current version) will place the new
configuration in /etc/weewx/weewx.conf.X.Y.Z
, where X.Y.Z
is the
new version number. It can then be compared with your old version which
will be in /etc/weewx/weewx.conf
.
Note
In most cases you should choose N
(the default).
Uninstall¶
To uninstall WeeWX, but retain configuration files and data:
sudo apt remove weewx
To uninstall WeeWX, deleting configuration files but retaining data:
sudo apt purge weewx
To delete data:
sudo rm -r /var/lib/weewx
sudo rm -r /var/www/html/weewx