Troubleshooting

Container Won't Start

Check Logs

docker-compose logs -f app

Common Causes

• Missing or invalid NEXTAUTH_SECRET
• Incorrect NEXTAUTH_URL
• Port already in use
• Database file permissions

Database Migration Errors

If migrations fail:

1. Check database file permissions
2. Ensure DATA_PATH directory exists and is writable
3. Try rebuilding: docker-compose up -d --build
4. Check logs for specific error messages

Can't Access Application

Check Container Status

docker-compose ps

Verify Port

Ensure the port in NEXTAUTH_URL matches HOST_PORT:

# Check if port is accessible curl http://localhost:3416

Authentication Issues

• Verify NEXTAUTH_SECRET is set and valid
• Check NEXTAUTH_URL matches your actual URL
• Clear browser cookies and try again
• Check that the master database exists and is accessible

Performance Issues

• Check container resource limits in docker-compose.yml
• Monitor memory usage: docker stats
• Consider increasing memory limit if needed
• Check database file size - large databases may be slower

Data Loss Prevention

• Always backup before major changes
• Never delete database files without backup
• Test backups regularly
• Keep multiple backup copies

Getting Help

If you're still experiencing issues:

• Check the FAQ page for common questions
• Review application logs for error messages
• Check the GitHub repository for known issues
• Ensure your Docker and system are up to date