jenkins-docs / jenkins-docs/quickstart-tutorials

Make GHCR Docker images publicly accessible

Open
#1,781 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug docker documentation
Dominant language
Shell
Stars
33
Forks
359
Avg merge
6h 35m
Merged PRs (30d)
61

Description

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/

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with docker-compose.yaml and the GHCR package named in the issue, then check whether its visibility settings allow an anonymous pull. Verify each listed tutorial image with docker pull and confirm the relevant docker compose profiles start without GitHub authentication.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, docker-compose, github
Domain
devops, documentation
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.