How to change a project image

Ways the image changes

The behavior depends on the project source.

Projects created from an OCI image

• You can change the OCI image in the console whenever you want to publish a new version.
• Public images require no authentication.
• Private images can use AWS ECR or username + token/password authentication.
• The authentication type cannot be changed after creation.

Important: In projects with an OCI image source, a new version is published by changing the image, as described on this page.

Projects created from a Git repository

This applies to repositories on GitHub and Forgejo.

• Git-based projects do not later switch to a manual OCI image flow.
• The image is produced by the build from the repository. The Deployment mode defines what starts a new build: Manual (only through the deploy button), Automatic by branch (push to the selected branch), By Tag (creation of a tag matching the pattern), or By Release (publication of a release matching the pattern).

Points to keep in mind

• Changing an OCI image can restart the instance.
• For Git-based projects, a push to the selected branch triggers an automatic update only when Automatic by branch is selected.
• A public image stays public and a private image stays private after creation.