Installation on Mac and Linux

In the future, much of the instructions below will be automated so that setup is quick and painless.

This has been tested on Mac OSX 10.11 and Ubuntu 14.04.

Create the Virtual Environment

It is recommended to run Tenma in a Python Virtual Environment.

1. Install Python 3.5 or greater: https://www.python.org/
2. Run the following commands in Terminal:
   1. Install Virtual Environment: pip install virtualenv
   2. Change to the directory you want install Tenma. For example, if you want to install this in your Documents folder: cd ~/Documents/
   3. Create your virtual environment: virtualenv -p python3 venv
   4. Activate virtual environment: source venv/bin/activate

Install Tenma

1. Download the repository, unarchive it, and rename it to tenmaserver.
2. Copy tenmaserver to the venv directory.
3. Run the following commands in Terminal:
   1. Change into the tenmaserver directory: cd ~/Documents/venv/tenmaserver
   2. Install dependencies: pip install -r requirements.txt
   3. Generate a secret key (for Django security): python manage.py generatesecretkey
   4. Create your database: python manage.py migrate
   5. Create your admin user: python manage.py createsuperuser
4. Open a second terminal window and run the following commands:
   1. Change into the venv directory: cd ~/Documents/venv
   2. Activate virtual environment: source venv/bin/activate
   3. Change into the tenmaserver directory: cd ~/Documents/venv/tenmaserver
   4. Start up Celery for task management: celery -A tenma worker --loglevel=info
   5. Keep Celery running!

Get Running!

1. Start your local server: python manage.py runserver [YOUR IP ADDRESS]:8000
   • For example: python manage.py runserver 192.168.1.30:8000
2. In your browser, go to http://[YOUR IP ADDRESS]:8000
   • For example: http://192.168.1.30:8000

Next, you'll want to import your comics.