Context

You may want to deploy a Docker image hosted on GitHub Container Registry (GHCR) or another third-party container registry as an application on Porter, and are wondering whether this is supported and how to authenticate.

Answer

Currently, Porter only supports deploying Docker images from the following sources:

• Public Docker images (accessible without authentication)

• Images pushed to a registry on the same cloud account where your Porter cluster is provisioned (e.g., ECR for AWS, GAR/GCR for GCP, ACR for Azure)

Third-party private registries such as GitHub Container Registry (GHCR) are not directly supported for pulling images at this time.

If you need to deploy an image currently hosted on GHCR or a similar registry, the recommended approach is to push the image to a supported registry using the Porter CLI:

1. Install and configure the Porter CLI.

2. Run the following command to push your image to your cloud account's container registry:
   porter app push

3. Once pushed, deploy your application by selecting Create Application in the Porter dashboard, choosing Deploy from a container registry, and entering the new image URL and tag.

For more details, refer to the following documentation:

• Deploy from a Docker Registry

• porter app push CLI Reference