Installation - short version

• Install requirements (Python, SetupTools and PIL)
• Download and untar (or unzip) twistranet from https://github.com/numericube/twistranet/tarball/master
• In the unzipped directory, just execute:
  • (sudo) python ./setup.py install clean

twistranet is now installed. You can have many sites with just one twistranet installation, so you need to explicitly deploy and bootstrap your new site.

• (sudo) twistranet_project <path_to_my_new_site>

Don't forget to write down your generated admin password!!

Your server should now be fully working and running on http://localhost:8000 !

If you want to start it again:

• cd <path_to_my_new_site>
• python ./manage.py runserver 0.0.0.0:8000

Installation - the Big Picture

Installation is in fact a 2 steps process. You must install twistranet's core features as a python library, then you have to create a project (which is an instance of a twistranet site).

To install twistranet's core features:

• Download and install Python >= 2.6 (with setuptools and PIL)
• Execute (as a superuser) "easy_install numericube-twistranet" ; this will normally download and install twistranet and all dependencies.

To create a new project:

• In the directory you want your website files created, type "python twistranet_project -n [<template>] <project_path>",

  where <project_path> is the name of your site (it will be created by the process) ; <template> is the name of the project template to deploy. Currently admitted values are:

  • 'default' (which is... the default value), an empty project based on sqlite;
  • 'cogip', a sample french-language project of a fictious company called COGIP.

The '-n' (or '--no-bootstrap') is an option to tell the twistranet_project script not to bootstrap it immediately (the bootstraping process is the initial database feed).

You can do it by hand once (and only once!) with the following commands:

• Go to your <project_path>

• Review the settings.py file and local_settings.py, change to whatever suits your needs.

  Among other things, carefully choose your DATABASE scheme, your LDAP/AD settings and the 'admin' password that has been generated for you.

• Execute "./manage.py bootstrap" to build the database

Running Twistranet :

• Execute ./manage.py runserver 0.0.0.0 to start playing with twistranet.
• Point your browser at http://localhost:8000

No image / thumbnail on my fresh twistranet instance!

This is probably a problem with python-imaging installation. Just install PIL for your OS.

Under debian, the easiest is to do "apt-get install python-imaging".

error: Could not find required distribution Django

If you've got this message, that means the autoinstall procedure of twistranet can't install django automatically. Just install django (see www.django-project.org) either from sources or from a package from your OS, and run "python setup.py install" again.

Seems that it is a python-2.5 related problem.

I've lost my admin password!

It's easy to set a new one.

• Stop your server
• Run ./manage.py changepassword admin (and change your password)
• Start your server again

error when using mod_python

mod_wsgi is recommended, but if you need mod_python this little django1.2.5 hack is needed :

• in django.http.init: do not use "from mod_python.util import parse_qsl"

replace the lines 7 to 11 with:

from cgi import parse_qsl

Thanks to esimorre https://github.com/numericube/twistranet/issues#issue/6