docker_hub_username

Description

The docker_hub_username parameter configures Docker Hub authentication for the rack. When set alongside docker_hub_password, all image pulls from Docker Hub are authenticated, avoiding Docker Hub's anonymous pull rate limits.

Default Value

Not set (anonymous Docker Hub access).

Use Cases

Avoid Rate Limits: Docker Hub enforces rate limits on anonymous image pulls (100 pulls per 6 hours per IP). Authenticated pulls have significantly higher limits.
Private Images: Pull images from private Docker Hub repositories during builds and deployments.

Setting Parameters

Set both docker_hub_username and docker_hub_password together:

$ convox rack params set docker_hub_username=myuser docker_hub_password=dckr_pat_xxxxx -r rackName
Setting parameters... OK

Generate a read-only access token from Docker Hub Account Settings rather than using your account password.

Additional Information

When both credentials are set, the rack creates a Kubernetes image pull secret that authenticates all Docker Hub pulls across the cluster. This applies to both application image pulls and build-time base image pulls.

See docker_hub_password for the companion parameter.