Installation

DFIRTrack installation

Distributions

DFIRTrack was successfully tested and installed on the following distributions / versions:

• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS

Minimal installation

• clone repository: $ git clone https://github.com/stuhli/dfirtrack.git ~/dfirtrack
• create virtual environment: $ virtualenv -p /usr/bin/python3 ~/dfirtrack/venv
• activate virtual environment: $ source ~/dfirtrack/venv/bin/activate
• install dependencies: (venv) $ pip3 install -r ~/dfirtrack/requirements.txt
• change to DFIRTrack folder: (venv) $ cd ~/dfirtrack
• setup initial database data: (venv) $ python3 manage.py migrate
• create cache table: (venv) $ python3 manage.py createcachetable
• create admin user and follow the provided instructions: (venv) $ python3 manage.py createsuperuser
• start development server: (venv) $ python3 manage.py runserver or (venv) $ python3 manage.py runserver 0:8000
• browse to localhost:8000 or :8000 and log in
• proceed with troubleshooting section, if you encounter errors

Troubleshooting

No static files

If you use this development setup for testing and your browser can't get static files, turn on debug mode.

• dfirtrack/settings.py or dfirtrack/local_settings.py
  • DEBUG = True

No login possible

If you use this development setup for testing and can't login (valid credentials, but redirects to login page without error), it has to do with the fact that the session cookies are not sent over insecure HTTP.

• dfirtrack/settings.py or dfirtrack/local_settings.py
  • SESSION_COOKIE_SECURE = False

Some browsers may send cookies over insecure HTTP even with Secure flag if the host is localhost, so debugging might be a bit confusing.

Production installation

• use Ansible for DFIRTrack and follow the steps provided in its Wiki
• or use your own favorite setup