Visit djangoplay.org ↗
issuetracker / Runbooks / Troubleshooting
DocsGeneric Issue TrackerRunbooksTroubleshooting

Troubleshooting

Check:

1 min readApplies to v0.6.0
On this page ▾
  1. Application does not start
  2. Database errors
  3. Authentication failure
  4. Authorization failure
  5. Issue updates fail

Application does not start

text
configuration
dependencies
database connectivity
migration state
port availability
logs

Database errors

Verify:

text
database URL
credentials
database availability
migration state

Then run the project's configured migration/status command.

Authentication failure

Check:

text
identity provider configuration
session/token configuration
cookie/security settings
clock synchronization

Authorization failure

Determine whether the user has:

text
valid identity
project membership
required project role
required issue permission

Do not solve authorization failures by disabling access checks.

Issue updates fail

Check:

text
request validation
issue state transition rules
user permissions
database constraints
concurrent update handling