Deployment

DefectDojo troubleshooting

Restart, reset and recover a DefectDojo instance.

Recovering the optional DefectDojo instance. For the ScanSuite platform itself, see Troubleshooting.

Restart DefectDojo

bash
cd ~/apps/scansuite/defectdojo && sudo docker compose down -t 0
sudo docker compose up -d

Update the admin password

Shell
cd ~/apps/scansuite/defectdojo && ./dojo-password

The password is removed after a DefectDojo restart. Write it down and store it somewhere safe.

Reset the database

In exceptional cases, reset the DefectDojo database. This command clears the DefectDojo database and restarts it from scratch:

Shell
~/apps/scansuite/defectdojo/reset-dojo

Resetting the database destroys every finding and product stored in DefectDojo. It also generates a new admin user, so you will need to fetch a new API key and update the ScanSuite settings.

After the reset, wait a few minutes and check for the new password:

Shell
cd ~/apps/scansuite/defectdojo && ./dojo-password

Then re-connect it to ScanSuite — see Set up DefectDojo (Optional).

Further reading

For more detail refer to the official DefectDojo repository and documentation.

Last reviewed 2026-08-23