/treeio

Tree.io

Primary LanguagePythonOtherNOASSERTION

Build Status

========================== Tree.io Business Management Platform

Tree.io is a powerful business management platform with tons of great features including integrated Project Management, Help Desk (support ticketing) and CRM modules. For a full list of features please see http://www.tree.io

Click here to watch a video of our lightning talk presentation at Djangocon Europe 2012.

For FAQ see the Tree.io community site http://www.tree.io/community/

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

  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 https://github.com/treeio/treeio.git
  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.pip
  8. DJANGO_DIR=`python -c "import django; import os; print os.path.dirname(django.__file__)"`
  9. 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
  1. Install mysql, client libraries and python driver: sudo apt-get install mysql-server mysql libmysqlclient-dev python-mysqldb
  2. Install your database: python manage.py installdb
  3. 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

  1. Run the built-in Django server python manage.py 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)

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.

Bitdeli Badge