Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Fixed #112 -- Added Django 1.6 support Mar 19, 2014
build Revert "Removed chat and bottom toolbar" Jan 3, 2012
ci before install oracle running oracle configure Apr 20, 2015
doc django setup app Sep 2, 2015
formats Ran autopep8 on codebase. Removed a lot of violations. Mar 19, 2014
install added git to ubuntu install script Apr 9, 2015
locale fixed/updated pt-br translations, thanks to Cristiano Ricardo Lima Costa Aug 4, 2015
logs Adding logs dir Jul 16, 2013
minidetector Tests are passing with django 1.7 Jun 16, 2015
script Ran autopep8 on codebase. Removed a lot of violations. Mar 19, 2014
sql Adding depends_id column to projects_task table #59 fixes #43 Jul 16, 2013
static removed unnecessary ; Apr 11, 2015
storage/search Initial import Nov 9, 2011
templates Tests are passing with django 1.7 Jun 16, 2015
treeio more tests Nov 3, 2015
treeio_project issue #154 Jul 19, 2015
.coveragerc improved some model tests Feb 28, 2015
.gitignore resolved conflict issues, tests are passing now Feb 7, 2015
.landscape.yaml tweking landscape config Nov 3, 2015
.travis.yml gave up testing on oracle on travis, made sh to test oracle using cen… Apr 9, 2015
LICENSE Update LICENSE Jul 21, 2012
README.markdown did some todos Nov 3, 2015
data.json formated data,json so we can start cleaning up Jan 20, 2015
fcgi Fixed permissions again Dec 16, 2011
gunicorn_start new gunicron starter Apr 11, 2014 Fixed #112 -- Added Django 1.6 support Mar 19, 2014
myinitial_data.json adding initial_data.jason for tests Jun 16, 2015
nginx.conf Example settings Nov 12, 2011
requirements.txt more tests Aug 8, 2015
runcron Fix runcron command. Well, somewhat fixed. Dec 20, 2011
setup.cfg Fixed #111 -- Cleaned up PEP8 violations. Mar 19, 2014
treeio.ini added caching settings, will use memcached if pylibmc is installed, w… Feb 27, 2015 fixed the new path issues Feb 11, 2015


Build Status Coverage Status Scrutinizer Code Quality Code Health

========================== Business Management Platform

Version 2.0 is under development, help appreciated, create issues and pull requests

join our mailing list:!forum/treeio

Already done:

  • Django 1.6 support
  • Install script for ubuntu


  • Django 1.7 support - beta, tests are running on 1.7 already, please test and let me know if something don't work
  • Django 1.8 support
  • Get to 100% test coverage
  • Resolve scrutinizer and landscape issues
  • Documentation
  • Help putting the site back online
  • Expanding travis test scenarios
  • Selenium tests
  • Leave django-piston to tastypie or DRF


For those installing with Apache check out this tutorial:

Amazon AMI

There is also a pre-built micro Amazon AMI Image available which will run on Amazon's Free Usage Tier for 1 year.

There is also now a Docker Container and bootstrap script to run treeio and a micro PostgreSQL instance inside Docker:

Docker Container Installation

07/2013: I have created a Docker container and a shell script to create a postgresql instance and a dynamically configured treeio instance.

To use this you only need to install Docker and run this script:

License is licensed under the MIT License. See the LICENSE file. comes with no warranty, Ltd. can accept no responsibility for any damages, losses etc.

Installation on Ubuntu or Debian with MySQL

Although you can install on most any UNIX system very easily, debian based distros are easier due to their package management.

You can also install on Max OSX or with other databases aside from MySQL very easily.

Install any dependencies

  1. Update your local cache sudo apt-get update
  2. Upgrade your system sudo apt-get upgrade (Recommended but optional)
  3. sudo apt-get install python build-essential python-dev
  4. sudo apt-get build-dep python-lxml python-imaging
  5. sudo apt-get install git python-flup python-pip python-virtualenv

Install services (In Production)

  1. Install database sudo apt-get install mysql-server (Aside from MySQL you can also use Postgre, SQLite or OracleDB)
  2. Install web server sudo apt-get install nginx

Alternatively you can use Apache, see this community post for an example configuration and read this GitHub issue which clarifies things further.

Create a clone of this repository

  1. Make a directory for treeio and go inside mkdir treeio && cd treeio
  2. Clone the repo by running: git clone
  3. Go into this directory cd treeio (The directory structure should be treeio/treeio/<project files>)
  4. Create a virtual environment to keep your packages & versions thereof separate from the rest of the system virtualenv venv
  5. Activate the virtual environment source ./venv/bin/activate
  6. Install system prerequisites for image processing module according to instuctions
  7. Install dependencies: pip install -r requirements.txt
  8. DJANGO_DIR=`python -c "import django; import os; print os.path.dirname(django.__file__)"`
  9. Run the patch: python $DJANGO_DIR

Install the database (Example showing MySQL)

$ mysql -u treeio -ptreeio
       > create database treeio;
       > grant all privileges on treeio.* to treeio@localhost identified by 'treeio';
       > \q
  1. Install mysql, client libraries and python driver: sudo apt-get install mysql-server mysql libmysqlclient-dev python-mysqldb
  2. Install your database: python installdb
  3. Setup initial data: python loaddata data.json or if using mysql: mysql -u treeio -ptreeio treeio < sql/mysql-treeio-current.sql

Test install

  1. Run the built-in Django server python runserver
  2. In your browser go to http://localhost:8000
  3. Log in using username: admin and password: admin
  4. Profit!

Next steps (In Production)

  • Configure nginx
  • Set up a mailserver
  • Set up a domain to point to your new server (Set A Record)


Commercial installation and support is available from Ltd, London, UK. Please see or contact for more details.


  • Spanish translation contributed to by @sytabaresa
  • Greek translation contributed by Nick Apostolakis
  • Brasilian Portugese translation contributed by Davi Ribeiro
  • Simple Chinese translation contributed by @sunliwen
  • French translation contributed by
  • An achievements addon is available courtesy of Pascal Mouret as shown in our Djangocon Europe video.

Bitdeli Badge