summaryrefslogblamecommitdiff
path: root/weewx/README
blob: a67724001824fd845d0ac2a3ae8600f9527867e5 (plain) (tree) 
8cceff0




































































1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
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
    }