GitHub Container Registry
By GitHub, Inc.
GitHub Container Registry (GHCR) is a container and OCI image registry integrated directly into GitHub, letting teams store and manage Docker and other OCI-compliant images alongside their source code and permissions.
Definition
GitHub Container Registry (GHCR) is a container and OCI image registry integrated directly into GitHub, letting teams store and manage Docker and other OCI-compliant images alongside their source code and permissions.
Overview
GitHub Container Registry lets developers push and pull container images using the `ghcr.io` hostname, with each image tied to a GitHub user, organization, or repository. Because it shares GitHub's existing permission model, access to a private image can be controlled through the same organization roles and repository access used for source code, and images can be linked to the repository whose workflow produced them for traceability. GHCR is commonly used together with GitHub Actions, where a workflow builds a Docker image and pushes it to `ghcr.io` as part of a CI/CD pipeline, avoiding the need to manage credentials for a separate registry like Docker Hub or Amazon ECR. It supports both public and private images, and — like other OCI registries — can also store other OCI artifact types beyond traditional container images.
Key Features
- Container and OCI image storage at the ghcr.io hostname
- Permissions inherited from GitHub organization and repository access
- Tight integration with GitHub Actions workflows
- Public and private image visibility settings
- Image-to-repository linking for build provenance
- Support for OCI artifacts beyond container images
Use Cases
Frequently Asked Questions
From the Blog
Git and GitHub for Beginners: A Complete Guide
Git tracks your code history; GitHub hosts it — learn the essential version control workflow every developer uses.
Read More ProgrammingGit and GitHub for Beginners: The Complete Guide
Git is the version control system used by virtually every software team on the planet. This beginner guide explains commits, branches, merges, and pull requests clearly, with the exact commands you'll use every day as a developer.
Read More AI & TechnologyBest AI Tools for Developers in 2026
GitHub Copilot, Cursor, and more — the standout AI tools that developers are using daily in 2026.
Read More Cloud & CybersecurityCI/CD Explained: Build, Test, Deploy
CI/CD is how modern software teams ship code dozens of times a day without breaking things. This guide explains what continuous integration and continuous delivery mean, how a pipeline works, and how to set up your first one with GitHub Actions.
Read More