==========================
setting-up-a-pylowiki-site
==========================
.. raw:: html
Setting up a pylowiki site
==========================
This page will outline the steps needed to setup a production pylowiki
site.
If you are interested in running a demo or local version of pylowiki,
check out the `minimal pylowiki setup
instructions `__.
In this tutorial we will be configuring pylowiki to run:
- on ubuntu linux
- as a wsgi application
- with an apache2 webserver
- in a python virtualenv
- with a mysql database backend
.. container::
Get the Pylowiki sourcecode
---------------------------
The pylowiki sourcecode is hosted at
`bitbucket.org `__. You will need mecurial (hg)
revision control to download the source.
For debian or ubuntu
::
sudo apt-get install mercurial
Once you have mercurial you need to clone the pylowiki sourcecode
::
hg clone http://bitbucket.org/russellballestrini/pylowiki
mv pylowiki mysite
Now you should have the sourcecode in local filesystem. You might want
to come up with a workflow to maintain your changes and still accept
revisions from the upstream pylowiki repository. I'll leave that up to
you.
Fix file permissions
--------------------
The web server account only needs access to a few directories. All the
other files may be owned by your id.
Run the following commands from the root of your Pylowiki project
directory to correct permissions.
.. container::
:name: cb3
::
mkdir egg-cache data
sudo chgrp -R www-data pylowiki/public/attachment
sudo chmod -R 774 pylowiki/public/attachment
sudo chgrp -R www-data egg-cache
sudo chmod -R 774 egg-cache
sudo chgrp -R www-data data
sudo chmod -R 774 data
Get a Pylons virtual environment
--------------------------------
Official Pylons setup notes:
http://pylonshq.com/docs/en/1.0/gettingstarted/
.. container::
:name: cb4
::
wget http://www.pylonshq.com/download/1.0/go-pylons.py
python go-pylons.py virtpy
To enable the virtual environment run:
.. container::
:name: cb5
::
source virtpy/bin/activate
Install your Pylowiki application
---------------------------------
Make sure your currently inside your virtual python environment. Your
shell should look like this:
.. container::
:name: cb6
::
(virtpy)user@host$ python setup.py develop
Notice the (virtpy)? The above command will install Pylowiki and all its
dependencies into your virtual pythons site-lib.
Configure Pylowiki - prod.ini
-----------------------------
The following command should be run in the root of your pylowiki
project. This will create a configuration ini named prod.ini:
.. container::
:name: cb7
::
(virtpy)user@host$ paster make-config Pylowiki prod.ini
Open prod.ini for editing and make changes to reflect your environment.
Database settings, public wiki registration, all the tweak-able settings
are declared in the ini.
Prepare mySQL Database
----------------------
Login to mySQL as root.
::
mysql -u root -p
mysql>
CREATE DATABASE mysite
GRANT ALL PRIVILEGES ON mysite.* TO username@localhost IDENTIFIED BY 'passw0rd' WITH GRANT OPTION
Now make sure the prod.ini reflects these database settings:
.. container::
:name: cb9
::
sqlalchemy.url = mysql://username:password@127.0.0.1/mysite?charset=utf8
sqlalchemy.pool_recycle = 3600
Now we can let Pylowiki create all the database tables by issuing the
following command:
.. container::
:name: cb10
::
(virtpy)user@host$ paster setup-app prod.ini
Configure mod_wsgi dispatch file
--------------------------------
First step is to create the mod_wsgi dispatch file.
From the root directory of the Pylowiki project, create a
*dispatch.wsgi* file with the following content:
.. container::
:name: cb11
::
# Add the virtual Python environment site-packages directory to the path
import sys
sys.stdout = sys.stderr
import site
site.addsitedir('/absolute/path/to/virtpy/lib/python2.6/site-packages')
# Avoid ``[Errno 13] Permission denied: '/var/www/.python-eggs'`` messages
import os
os.environ['PYTHON_EGG_CACHE'] = '/absolute/path/to/pylowiki/egg-cache'
# Load the Pylons application
from paste.deploy import loadapp
application = loadapp('config:/absolute/path/to/pylowiki/prod.ini')
Configure apache2 virtualhost
-----------------------------
Create a domain file under /etc/apache2/sites-enabled.
.. container::
:name: cb12
::
sudo vi 002-mysite
#mysite.net
#pylons embeded mod_wsgi
ServerName www.mysite.net
ServerAlias mysite.net
ServerAdmin admin@mysite.com
# ReWrite URL to WWW
RewriteEngine On
RewriteCond %{HTTP_HOST} ^mysite.net
RewriteRule (.*) http://www.mysite.net$1 [R=301,L]
# Log Files
ErrorLog /var/log/apache2/error-mysite.log
CustomLog /var/log/apache2/access-mysite.log combined
# Setup mod_wsgi
WSGIScriptAlias / /absolute/path/to/pylowiki/dispatch.wsgi
Restart the apache2 service:
.. container::
:name: cb13
::
sudo service apache2 restart
foxhop — `Oct 08, 2010 03:23 pm `__
------------------------------------------------------------------------------------------------------------------------------------------------------------
Please contribute to this installation documentation.
--------------
| **Source:**
https://foxhop.net/f2924939-2f95-11f1-8a03-e86a64d24d78/setting-up-a-pylowiki-site
| **Snapshot:** 2026-09-14T12:03:02Z
| **Generator:** Remarkbox ``695de26``