Troubleshooting: User Docker Installation

Common issues when running PyRIT with Docker.

JupyterLab Not Accessible¶

Problem: Cannot access http://localhost:8888

Solutions:

1. Check if the container is running:

   docker ps

2. View container logs:

   docker-compose logs pyrit

3. Ensure port 8888 is not already in use:

   # On Linux/macOS
   lsof -i :8888
   
   # On Windows (PowerShell)
   netstat -ano | findstr :8888

Permission Errors¶

Problem: Permission denied errors when accessing notebooks or data

Solution: Set appropriate permissions:

chmod -R 777 notebooks/ data/ ../assets/

Missing Environment Files¶

Problem: Container fails with missing environment file errors

Solution: Ensure all environment files are created:

ls -la ../.env ../.env.local .env.container.settings

If any are missing, create them from the examples as shown in the Docker Installation guide.

Container Build Fails¶

Problem: Docker build fails with dependency errors

Solutions:

1. Clear Docker cache and rebuild:

   docker-compose build --no-cache

2. Ensure you have sufficient disk space:

   docker system df

3. Prune old images if needed:

   docker system prune -a