Due to lack of time I can no longer maintain Tree. If you are interested in working on it get in touch
For those installing with Apache check out this tutorial: http://www.makeyouadmin.com/2014/04/install-treeio-on-ubuntu-with-apache-mysql.html#.U1KlJKaINQI
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:
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
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.
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.
- 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 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.
- 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 betreeio/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
$ 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
- 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!
- 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 Tree.io Ltd, London, UK. Please see http://www.tree.io/ or contact [email protected] for more details.
- 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.