manual_install.md

Manual Installation

Clone the project from repository with ssh:

$ git clone [email protected]:superfluidity/RDCL3D.git

or https:

$ git clone https://github.com/superfluidity/RDCL3D.git

Prerequisites

• Python >= 2.7
• pip
• virtualenv (virtualenvwrapper is recommended)

Installation

Install a recent Django version as shown in in the install guide.

Install pip as shown in the install guide

then move in Django project directory

If you want to use a python virtual environment as shown in in the guide call the directory simply "env" (otherwise remember to add the new directory in .gitignore file):

cd /home/user/workspace/RDCL3D/code

virtualenv env

To setup a local development environment:

source env/bin/activate

pip install -r requirements.txt

For the first time:

$ python manage.py makemigrations sf_user projecthandler deploymenthandler

$ python manage.py migrate

you must create a new super user:

$ python manage.py createsuperuser

To run the server:

$ python manage.py runserver

or:

$ python manage.py runserver [host]:[port] 
$ python manage.py runserver 0.0.0.0:8000

Development hints

In order to keep your environment consistent, it's a good idea to "freeze" the current state of the environment packages. To do this, run

$ pip freeze > requirements.txt

To add a new site to your existing Django project, use the startapp task of manage.py utility.

$ django-admin.py startapp [name_django_app]