weewx: setup scripts and patches

Make installation on OpenBSD easier.

1 files changed, 68 insertions, 0 deletions

diff --git a/weewx/README b/weewx/README
new file mode 100644
index 0000000..a677240
--- /dev/null
+++ b/weewx/README
@@ -0,0 +1,68 @@
+Instructions for installing WeeWX:
+
+https://www.weewx.com
+
+Reference guide at: https://www.weewx.com/docs/setup.htm
+
+    pkg_add py3-configobj py3-Pillow py3-serial py3-pyusb py3-cheetah
+
+Download and unpack (assuming latest version is 4.8.0):
+
+    curl -O https://weewx.com/downloads/weewx-4.8.0.tar.gz
+    tar zxvf weewx-4.8.0.tar.gz
+
+`cd` into the source directory and apply `setup.py-Add-config-name-option.patch`
+
+    patch -p1 < setup.py-Add-config-name-option.patch
+
+If you don't wish to let Google know every time you check the weather,
+apply the following patch:
+
+    patch -p1 < XXX-de-google-font-XXX.patch
+
+Copy the setup.cfg from this directory into the weewx source
+directory.
+
+Configure and install:
+
+    python3 setup.py build
+    doas python3 setup.py install --config-name /etc/weewx/weewx.conf
+
+Create a user for the daemon
+
+    # logname: weewx
+    # login class: daemon
+    # primary group: weewx
+    # supplementary groups: dialer, daemon
+    # no home
+    # login disallowed
+    useradd -c "WeeWX Daemon" -d /var/empty -G dialer,daemon -g =uid -L daemon -s /sbin/nologin weewx
+
+Fixup permissions:
+
+    doas chown -R weewx /var/www/weewx
+
+Install rc script and enable daemon:
+
+    doas install -m 0555 weewx.rc /etc/rc.d/weewx
+    doas rcctl enable weewx
+    doas rcctl start weewx
+
+Modify `httpd` configuration:
+
+ * Ensure that a line similar to this is in the `types` block (create
+   a `types` block if needed, see `httpd.conf(5)`):
+
+    text/html  html htm
+
+ * Add these lines to the appropriate `server` block in `/etc/httpd.conf`:
+
+    location "/weewx/docs" {
+      request rewrite "/weewx/docs/usersguide.htm"
+    }
+
+
+    location "/weewx/*" {
+      root "/weewx/docs"
+      request strip 1
+    }