Docker Issues

Troubleshoot common Docker permission, pull rate, and log collection issues for Xyte Edge.

Troubleshoot common Docker-related Xyte Edge issues using the table below.

Scenario or errorLikely meaningRecommended next steps
Docker: Permission denied while trying to connect to Docker APIYour user does not have permission to access the Docker daemon.To fix it permanently:
1. Run sudo usermod -aG docker $USER
2. Log out and back in so the change takes effect
Docker: You have reached your pull rate limitDocker Hub is rate-limiting image pulls for your account or IP.Next steps:
1. Review Docker's pull rate guidance: Increase rate limits
2. Check your current pull usage: View pull rate and limit
3. Authenticate with Docker or upgrade your plan if you hit this limit often
Docker: How to extract Docker logsYou need Docker container logs for review or support.Use the command that matches your operating system:

Linux/macOS
docker logs -t xyte_edge > xyte_edge_logs.txt 2>&1

Windows (CMD)
docker logs -t xyte_edge > xyte_edge_logs.txt 2>&1

Windows (PowerShell)
docker logs -t xyte_edge 2>&1 | Out-File -FilePath xyte_edge_logs.txt

What’s Next