Debugging A Dev Install

Debugging and Testing Docker Installs

Stopped Containers and startup checks

Diffgram has a built in system startup checker and self tests. During development we run tests on the software itself. This is different. These startup checks are designed to help verify that for your specific configuration everything is inline. Sometimes if a startup check fails it will prevent a container from starting. Check for stopped containers.

Env vars

Docker may not refresh env variables. Please be aware of this when testing, for example you may change the .env file but not see any change. You may need to recreate containers or follow the most current best practice for updating env variables.

Debugging All Cases

  • Does it work on diffgram.com?
  • Does it work locally? (e.g. if running on cloud)

If you run into an issue to best help solve it please contain as much info as possible, e.g.

  • Complete error logs, sometimes a screenshot can show more context then copying the specific log
  • Env file
  • Diffgram version
  • Information from SuperAdmin/Install Info page
  • Screenshots/Video
  • Hardware context, where is it running?
  • Did the requirements.txt install all properly? If not, has PIP been successfully updated?

Viewing Install Logs

The install.py script uses docker compose to launch containers. You can do docker compose logs to visualize diffgram logs.