Skip to main content

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.