Troubleshooting

Common issues and solutions for self-hosted Docka.

Database Connection Failed

# Test connection
psql "$DATABASE_URL" -c "SELECT 1"

# Check PostgreSQL is running
sudo systemctl status postgresql

# Check logs
sudo journalctl -u docka -f

Health Check

# Check server health
curl http://localhost:8080/health

# Expected response:
# {"status":"healthy","timestamp":"...","version":"1.0.0"}

View Logs

# Systemd
sudo journalctl -u docka -f

# Docker
docker compose logs -f server

Common Issues

Port Already in Use

# Find what's using port 8080
sudo lsof -i :8080

# Change the port in your config
PORT=8081

Permission Denied

# Fix permissions
sudo chown -R docka:docka /etc/docka
sudo chmod 600 /etc/docka/env

Database Migrations

Migrations run automatically on first start. If you need to re-run:

# The server runs migrations on startup
sudo systemctl restart docka