Get TurtolCMS news

Your Email Address


Installation

How you install the TurtolCMS depends on your platform and other factors.  This page covers installation for a few different configurations, but we haven't (and maybe can't) considered all possibilities.  If you're handy with a keyboard, you should be able to get it working with these instructions.  If you're new to Unix, Python and Apache, give it a go, and contact us if you run into trouble.  If you just don't want to deal with it, we can host it for you.

Prerequisites

  • Apache 2.0 or later (we've only tested with the prefork MPM on Linux)
  • Python 2.4 or later
  • mod_python 3.2.10 or later
  • ClearSilver 0.10 or later (optional)
  • Django 0.96 or later (optional)
  • MySQL 4.1 or later OR PostgreSQL 7.3 or later
  • Your imagination!

Installing with distutils

  1. Download and extract the source distribution
  2. Change into the extracted directory
  3. Run the usual distutils install (you may need to be root) with this command: 
    python setup.py install

Create A Database

Create a database using either MySQL or PostgreSQL. 

Configure Apache Vhost

In your httpd.conf or .htaccess file, add something like this:

 <Location /TurtolCMS>  (* use whatever uri you want, including /, but see below)
    SetHandler mod_python
    PythonHandler TurtolCMS.ApacheEntryPoint
    PythonPath "sys.path + ['path/to/your/extensions']" (* optional)
    PythonOption TCMS_DBURI "your-database-uri"
 </Location> 

If you want to host the TurtolCMS at the root URI ('/'), and this is how we recommend it, use:

<Directory /your/document/root>

Instead of <Location>. AND add this to the configuration block:

PythonOption TCMS_RAWURI 1


The database URI takes the form:

   engine://user:password@host[:port]/databasename

 For example:

    mysql://turtolcms:secretpassword@db.turtolcms.org/TurtolCMS