Troubleshooting
tip
Check the container logs to diagnose issues:
docker compose logs -f
Or for a specific service:
docker compose logs -f gateway
Common troubles
Containers fail to start
Check that all required environment variables are set in your .env file and that Docker Compose can read them:
docker compose config
GPU not available in container
Verify the NVIDIA Container Toolkit is installed correctly:
docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi
If this fails, reinstall the NVIDIA Container Toolkit and restart Docker:
sudo systemctl restart docker
DICOM studies are not being received
- Verify the SCP port is accessible from your PACS:
telnet <server-ip> 104 - Check the PACS AE configuration in the Configuration Guide
- Ensure the firewall allows inbound traffic on the configured port
Processed images are not returned to PACS
- Verify the Storage Destination settings (IP, port, AET) in the Configuration Guide
- Confirm the PACS is accepting C-STORE requests from the Gateway's AET
- Check container logs for connection errors