Skip to content

Make GHCR Docker images publicly accessible #1781

@gounthar

Description

@gounthar

Problem

Users following the Jenkins tutorials cannot pull Docker images from GHCR without authentication:

docker pull ghcr.io/jenkins-docs/quickstart-tutorials/jenkinsci-tutorials:android_
# Error: denied: denied

The docker-compose.yaml file references images from ghcr.io/jenkins-docs/quickstart-tutorials/jenkinsci-tutorials but these packages appear to be private, requiring GitHub authentication.

Impact

  • Tutorial users get 403 Forbidden errors when running docker compose --profile <name> up -d
  • Friction for new users trying to follow tutorials
  • Need to document authentication requirements or make images public

Expected Behavior

Images should be publicly accessible for tutorial users, similar to other public Jenkins images on Docker Hub.

Affected Images

All tutorial images:

  • simple_controller_
  • maven_agent_
  • python_agent_
  • node_agent_
  • android_agent_
  • golang_
  • cpp_
  • dotnet_
  • sidekick_
  • agent_discovery_

Suggested Solution

Make the GHCR package jenkins-docs/quickstart-tutorials/jenkinsci-tutorials publicly visible:

  1. Go to https://github.com/orgs/jenkins-docs/packages
  2. Find quickstart-tutorials/jenkinsci-tutorials
  3. Settings → Change visibility → Public

Workaround

Users can authenticate with GHCR:

echo "$GITHUB_TOKEN" | docker login ghcr.io -u USERNAME --password-stdin
docker compose --profile android up -d

Related

This affects all users of the quickstart tutorials documented at https://www.jenkins.io/doc/tutorials/

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingdockerPull requests that update Docker codedocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions