• This quick start guide assumes that you are already reasonably familiar with weeWX and that it is already installed on your computer. The weeWX folder must reside in the root directory of your web server. This is the default location if you followed the weeWX install process here
on a Debian based operating system (Debian, Ubuntu, Raspbian etc).
• To enable weeWX to communicate with the weather34 dashboard template, you must install the CRT plugin, (stands for Cumulus Real Time). Please follow the detailed instructions found here
• Download the weather34 weeWX template zip file from the weather34 downloads page here
• Extract all the files and folders and then upload them to the root directory of your web server, to sit alongside the weewx folder. Alternatively you may upload the zip file and then extract in-situ. (Please note that placing all the template files and folders in the root is a deviation from the recommendation for the Cumulus version of the template, which is to create a separate folder eg ‘pws’).
• Important. Depending on the configuration of your server, you may have to change your file permissions. Change all files and folders recursively in the root of your server to 0775 using CHMOD, either via the CLI or your server Control Panel (if you employ one). I use Webmin
, an open source control panel which will make your tasks much easier.
• You can now test that the template is working by opening it up in your browser. Initially you will see random demo data. Click on the menu button at the top-left corner and select settings. This will open up a web form in which you apply your own settings. Pay particular attention to the location of the realtime.txt file being generated on a loop cycle by weeWX. The default location is “/var/tmp/realtime.txt”
• Finally refresh your browser and you should see your own live weather station data. If things go wrong, check your settings carefully ensuring that the realtime.txt file and API keys and tokens have been correctly entered. If you have any issues please raise directly with firstname.lastname@example.org
An advanced guide will be made available soon which will explore some of the additional benefits from using weeWX. For example you can use your own real data to drive the various template charts rather than rely on retrieving data from sources such as Weather Underground. All this can be accomplished without needing to know or understand a single piece of SQL language.
many thanks to Ian Millard this guide was produced 6th September 2018