Installation using setup.py

These are generic instructions for installing weewx using the Python utility setup.py.

The installation will place weewx in the /home/weewx directory with the following layout:

Install Prerequisites

Ensure that Python2 is installed. Python 2.5, 2.6, or 2.7 will work, but Python 3 will not.

Then install required python packages using the package management software for your system (e.g., apt-get, yum, yast) or the Python Package Management System (pip). Select the appropriate tab for specific instructions.

# debian, ubuntu, mint
          
          # required packages:
          sudo apt-get install python-configobj
          sudo apt-get install python-cheetah
          sudo apt-get install python-imaging
          
          # required if hardware is serial or USB:
          sudo apt-get install python-serial
          sudo apt-get install python-usb
          
          # required if using MySQL:
          sudo apt-get install mysql-client
          sudo apt-get install python-mysqldb
          
	  # required if you are on Raspbian and planning on using FTP:
          sudo apt-get install ftp

          # optional for extended almanac information:
          sudo apt-get install python-dev
          sudo apt-get install python-pip
          sudo pip install pyephem

# redhat, centos, fedora
          
          # required packages:
          sudo yum install python-configobj
          sudo yum install python-cheetah
          sudo yum install python-imaging
          
          # required if hardware is serial or USB:
          sudo yum install python-setuptools
          sudo easy_install pyserial
          sudo easy_install pyusb
          
          # required if using MySQL:
          sudo yum install mysql-client
          sudo yum install python-mysqldb
          
          # optional for extended almanac information:
          sudo yum install pyephem

# suse
          # on some SuSE systems, use 'yast -i' instead of 'zypper install'

          # required packages:
          sudo zypper install python-configobj
          sudo zypper install python-imaging
          sudo zypper install python-Cheetah
          
          # required if hardware is serial or USB:
          sudo zypper install python-pyserial
          sudo zypper install pyton-usb
          
          # required if using MySQL:
          sudo zypper install mysql-community-server-client
          sudo zypper install python-mysql
          
          # optional for extended almanac information:
          sudo zypper install python-devel
          sudo zypper install setuptools
          sudo pip install pyephem

# python setup tool (pip)
          
          # required packages:
          sudo pip install configobj
          sudo pip install Cheetah
          sudo pip install pillow
          
          # required if hardware is serial or USB:
          sudo pip install pyserial
          sudo pip install pyusb
          
          # optional for extended almanac information:
          sudo pip install pyephem

Download

Install weewx

To specify a location different from the standard /home/weewx, modify the parameter home in the setup.cfg file.

The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to the station.

Run

cd /home/weewx
          sudo cp util/init.d/weewx.debian /etc/init.d/weewx
          sudo chmod +x /etc/init.d/weewx
          sudo update-rc.d weewx defaults 98
          sudo /etc/init.d/weewx start

cd /home/weewx
          sudo cp util/init.d/weewx.redhat /etc/rc.d/init.d/weewx
          sudo chmod +x /etc/rc.d/init.d/weewx
          sudo chkconfig weewx on
          sudo /etc/rc.d/init.d/weewx start

cd /home/weewx
          sudo cp util/init.d/weewx.suse /etc/init.d/weewx
          sudo chmod +x /etc/init.d/weewx
          sudo /usr/lib/lsb/install_initd /etc/init.d/weewx
          sudo /etc/init.d/weewx start

Status

Verify

After about 5 minutes, open the station web page in a web browser. You should see your station information and data.

If your hardware supports hardware archiving, then how long you wait will depend on the archive interval set in your hardware.

Customize

To enable uploads such as Weather Underground or to customize reports, modify the configuration file /home/weewx/weewx.conf. See the User Guide and Customization Guide for details.

Uninstall

To uninstall, simply delete the directory /home/weewx. This will delete weewx, configuration files, and data.

executable:	/home/weewx/bin/weewxd
configuration file:	/home/weewx/weewx.conf
utilities:	/home/weewx/bin/
skins and templates:	/home/weewx/skins/
sqlite databases:	/home/weewx/archive/
generated web pages and images:	/home/weewx/public_html/
documentation:	/home/weewx/docs/

weewx: Installation using setup.py