Troubleshooting

Common issues

Backend won't start

Check database connection:

docker compose logs backend

Ensure PostgreSQL is healthy and POSTGRES_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

# start community version
make community

# start pro version
make pro

This removes all volumes including the database.