The Flow Foundation node software container registry has been moved to AWS ECR. Please update your docker pull / service-unit image references to the new location for the current docker images and all future upgrades.
New Registry Location
public.ecr.aws/onflow
ECR Public pulls are anonymous and do not require an AWS account.
Mapping — Old vs New
Replace the registry prefix only. Tag names are unchanged.
| Image | Before (deprecated) | After |
|---|---|---|
| access | gcr.io/flow-container-registry/access:<tag> |
public.ecr.aws/onflow/access:<tag> |
| collection | gcr.io/flow-container-registry/collection:<tag> |
public.ecr.aws/onflow/collection:<tag> |
| consensus | gcr.io/flow-container-registry/consensus:<tag> |
public.ecr.aws/onflow/consensus:<tag> |
| execution | gcr.io/flow-container-registry/execution:<tag> |
public.ecr.aws/onflow/execution:<tag> |
| verification | gcr.io/flow-container-registry/verification:<tag> |
public.ecr.aws/onflow/verification:<tag> |
| flow-evm-gateway | us-west1-docker.pkg.dev/dl-flow-devex-production/development/flow-evm-gateway:<tag> |
public.ecr.aws/onflow/flow-evm-gateway:<tag> |
| observer | gcr.io/flow-container-registry/observer:<tag> |
public.ecr.aws/onflow/observer:<tag> |
All role images continue to be published with the same architecture variants where they existed before: <tag>, <tag>-arm, <tag>-without-adx, <tag>-without-netgo-without-adx.
What to Update
- Service units (
ExecStartPre=docker pull …,ExecStart=docker run …). - Deployment manifests / Helm values / Terraform / Ansible - anywhere the registry prefix is referenced.
- CI pipelines that pull Flow node images.
Tag selection (which flow-go version to run) is unchanged by this move - pick the version you intend to run, same as always.
Verification
Any image you can currently pull from the GCP registry should now be pullable from ECR Public with the same tag. You can confirm the content is identical by digest:
crane digest gcr.io/flow-container-registry/access:v0.51.2
crane digest public.ecr.aws/onflow/access:v0.51.2
# digests should match
Or simply pull and run as you normally would - behavior is identical, same binary bytes.
Timeline
- The new ECR Public location is live now and is already the source of truth for Foundation-operated nodes.
- The old GCP registry (
gcr.io/flow-container-registry) will continue to serve images for a transition period, but will soon be deprecated and taken down. - Please plan to migrate your configurations in the coming days.
Thank you!