Troubleshooting¶

Common issues¶

Backend won't start¶

Check database connection:

docker compose logs backend

Ensure PostgreSQL is healthy and SSC_DB_PASSWORD matches.

Caddy TLS errors¶

For local development, trust the self-signed certificate:

# Add to your system trust store
sudo cp caddy/data/certificates/servasec.local.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

Frontend shows blank page¶

Check the browser console for API errors. The frontend proxies /api/* to the backend through Caddy.

Scans fail to ingest¶

1. Verify the file format is supported (JSON, SARIF)
2. Check the scanner type is auto-detected
3. View backend logs: docker compose logs backend

Logs¶

# All services
make logs

# Specific service
docker compose logs backend
docker compose logs frontend

Reset¶

To completely reset:

make down-clean
make dev

This removes all volumes including the database.