Skip to navigationSkip to main contentSkip to footerScaleway Docs

Common errors when pushing images to Container Registry

Problem

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

Symptoms

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

Possible causes

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

Solutions

Verify authentication and authorization

  • 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 logs

  • 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 version

  • 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 issues

  • 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 limits

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

Additional troubleshooting steps

  • 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.
Still need help?

Create a support ticket
No Results