Tree.io Business Management Platform

Due to lack of time I can no longer maintain Tree. If you are interested in working on it get in touch

Apache

For those installing with Apache check out this tutorial: http://www.makeyouadmin.com/2014/04/install-treeio-on-ubuntu-with-apache-mysql.html#.U1KlJKaINQI

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: https://gist.github.com/funkotron/6025664

License

Tree.io is licensed under the MIT License. See the LICENSE file.

Tree.io comes with no warranty, Tree.io 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

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

Install services (In Production)

Install database sudo apt-get install mysql-server (Aside from MySQL you can also use Postgre, SQLite or OracleDB)
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

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

Install mysql, client libraries and python driver: sudo apt-get install mysql-server mysql libmysqlclient-dev python-mysqldb
Install your database: python manage.py installdb
Setup initial data: python manage.py loaddata data.json or if using mysql: mysql -u treeio -ptreeio treeio < sql/mysql-treeio-current.sql

Test install

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

Next steps (In Production)

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

Support

Commercial installation and support is available from Tree.io Ltd, London, UK. Please see http://www.tree.io/ or contact info@tree.io for more details.

Acknowledgements

Spanish translation contributed to by @sytabaresa
Greek translation contributed by Nick Apostolakis http://nick.oncrete.gr
Brasilian Portugese translation contributed by Davi Ribeiro
Simple Chinese translation contributed by @sunliwen
French translation contributed by morago.com
An achievements addon is available courtesy of Pascal Mouret as shown in our Djangocon Europe video.

learnning / treeio