- Install python 2.7 or 3.X if not already installed
- Install pip, if not already installed
- Make sure python and pip are in your path
- clone or download the repo from gituhub
- cd into the folder where manage.py is located
NOTE: You can use virtualenv if you want, or just install the requirements anyways.
- Run pip install -r requirements.txt to install the requirements
- Get the database setup with defaults:
- python manage.py makemigrations
- python manage.py migrate
- python manage.py loaddata contenttypes admin auth dashboard sessions
- sudo python manage.py collectstatic
- Start the server:
- You could use nginx or apache
- or, just run python manage.py runserver 0.0.0.0:8000
- You can specify any port. It doesn't have to be 8000
- or, uwsgi --http :8000 --module my_dashboard.wsgi if you are using MacOS or linux
- Navigate to localhost:8000
- Enjoy!
If you would like to run this site as public facing (i.e. can access it from work) you will need to add the hostname or IP to the ALLOWED_HOST section of /my_dashboard/settings.py and maybe some DNS stuff
ALLOWED_HOSTS = { 'REPLACE_WITH_HOSTNAME_OR_IP', }