diff --git a/README.rst b/README.rst index b5f7ec5..dd80a9d 100644 --- a/README.rst +++ b/README.rst @@ -300,6 +300,14 @@ scenarios: If you deploy Puppetboard through a different setup we'd welcome a pull request that adds the instructions to this section. +Installation On Linux Distros +^^^^^^^^^^^^^^^^^^^^^^^^ + +`Debian Jessie Install`_. + +.. _Debian Jessie Install: docs/Debian-Jessie.md + + Apache + mod_wsgi ^^^^^^^^^^^^^^^^^ diff --git a/docs/Debian-Jessie.md b/docs/Debian-Jessie.md new file mode 100644 index 0000000..4ecbd21 --- /dev/null +++ b/docs/Debian-Jessie.md @@ -0,0 +1,62 @@ +# Install Using debian jessie + +``` +$ apt-get install python-pip git + +$ mkdir /opt/voxpupuli-puppetboard/ +$ cd /opt/voxpupuli-puppetboard/ +$ git clone https://github.com/voxpupuli/puppetboard +$ cd /opt/voxpupuli-puppetboard/puppetboard +$ pip install puppetboard + +``` + +* /etc/apache2/sites-available/voxpupuli-puppetboard.conf + +``` + + ServerName puppetboard.my.domain + WSGIDaemonProcess puppetboard user=www-data group=www-data threads=5 python-path=/usr/local/lib/python2.7/dist-packages/puppetboard:python-home=/opt/voxpupuli-puppetboard/puppetboard:/opt/voxpupuli-puppetboard/puppetboard/puppetboard:/usr/local/lib/python2.7/dist-packages/puppetboard/static + WSGIScriptAlias / /opt/voxpupuli-puppetboard/puppetboard/wsgi.py + ErrorLog /var/log/apache2/puppetboard.error.log + CustomLog /var/log/apache2/puppetboard.access.log combined + + + + Order deny,allow + Allow from all + Require all granted + + + + Alias /static /usr/local/lib/python2.7/dist-packages/puppetboard/static + + Satisfy Any + Allow from all + Require all granted + + + + WSGIProcessGroup puppetboard + WSGIApplicationGroup %{GLOBAL} + Order deny,allow + Allow from all + Require all granted + + +``` + +``` +$ a2ensite voxpupuli-puppetboard.conf +``` + +* /opt/voxpupuli-puppetboard/puppetboard/wsgi.py +``` +from __future__ import absolute_import +import os + +import sys +sys.path.append('/opt/voxpupuli-puppetboard/puppetboard') + +from puppetboard.app import app as application +```