Follow these instructions to setup Developen on your local machine. These instructions are a work in progress so please add to it if you feel it is necessary.
These set up instructions are meant for Mac OS.
After cloning the repository to your local machine, you will need to setup a virtual environment. Navigate to your root project directory and do the following.
- Run
python3 -m virtualenv venv
to create a new virtual environment. - Run
source venv/bin/activate
to activate it. - Run
pip install -r requirements.txt
in order to install the required dependencies
- Download PostgreSQL.
- When prompted to do so, create a new PostgreSQL user with username
postgres
and passwordpostgres
. - Launch pgAdmin 4.
- Create a new server with a descriptive title.
- Create a new database called
developen
and give thepostgres
user access. - From project root directory run
python manage.py migrate
to create the database tables.
- Run
python manage.py createsuperuser
and enter a username and password when prompted.
- From project root run
python manage.py runserver
. - Go to
http://localhost:8000/projects/
in your browser to view the Developen application. - The administrator interface is viewable at
http://localhost:8000/admin/
.
- Always make sure your virtual environment is running before you start developing or run your application.
- You should be committing your migration files whenever they are created by the
python manage.py migrate
command.