---
since: 0.6.0
---

# Troubleshooting

## Application does not start

Check:

```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
```