Prebuilt image deployment
Deploy a public OCI image
Use the image path when you already have a build pipeline or want to use the compute on your own workstation.
01
Meet the launch image contract
Publish the image publicly on Docker Hub, GitHub Container Registry, Quay, or GitLab Container Registry. Private credentials and custom registries are not supported in the launch flow.
The image must support Linux amd64, listen on PORT=3000, and bind to 0.0.0.0. Use an image digest instead of a mutable tag when you need a repeatable release.
02
Create the web service
- 1Open Add project in an active App Cloud workspace.
- 2Choose Container image as the source.
- 3Paste the public image reference, preferably with its sha256 digest.
- 4Choose a launch region and decide whether to attach PostgreSQL.
- 5Create the project and follow its deployment status.
03
Update the image
Publish the replacement image first, then update the image reference from the project overview. Updating the source also starts a deployment.
Use Redeploy when you want to deploy the saved image reference again without changing it.
04
Verify the release
- 1Wait for the health check to pass.
- 2Open the project URL and test the paths that depend on environment variables or PostgreSQL.
- 3Use the project logs when the image starts but the application does not respond.
Next steps