Common errors when pushing images to Container Registry

ProblemLink to this anchor

You are unable to push images to Scaleway’s Container Registry.

SymptomsLink to this anchor

• The docker push command fails with an error message.
• Authentication or authorization errors occur.
• The image push process hangs or times out.

Possible causesLink to this anchor

• Incorrect authentication or authorization settings.
• Misconfigured or outdated Docker client.
• Network connectivity issues or firewall restrictions.
• Exceeded Container Registry quotas or limits.

SolutionsLink to this anchor

Verify authentication and authorizationLink to this anchor

• Ensure you are logged in with a valid Scaleway account using docker login.
• Confirm that your account has the necessary permissions to push images.
• Verify that your Docker client is correctly configured for Scaleway’s Container Registry.

Review error messages and logsLink to this anchor

• Run the push command with verbose output for more details:

  docker push --debug <your-image>
  

• Check the Docker client logs for warnings or errors:

  docker logs <container_id>
  

• Verify Scaleway’s Container Registry status for any ongoing incidents.

Check Docker configuration and versionLink to this anchor

• Ensure your Docker client is up-to-date by running:

  docker --version
  

• Check for configuration errors in the Docker daemon and client.
• Review the Docker documentation for known compatibility issues.

Investigate network connectivity issuesLink to this anchor

• Confirm that your internet connection is stable.
• Check firewall or proxy settings that may be blocking the connection.
• Try pushing the image from a different network or VPN to rule out local issues.

Verify Container Registry quotas and limitsLink to this anchor

• Ensure you have not exceeded your Scaleway Container Registry storage limits.
• Refer to Scaleway’s documentation for quota information.

Additional troubleshooting stepsLink to this anchor

• Try pushing a small test image to verify general functionality:

  docker pull alpine && docker tag alpine <your-registry>/test-image && docker push <your-registry>/test-image
  

• Review Docker’s official troubleshooting guides for further insights.
• If the issue persists, contact our support team with error logs and diagnostic details.