{"record":{"id":"eb3a5d58afaf6b98","repo":"remotion-dev/remotion","slug":"the-tag-for-remotion-version-version-was-not-fo","errorCode":null,"errorMessage":"The tag for Remotion version ${VERSION} was not found in the Cloud run registry.","messagePattern":"The tag for Remotion version (.+?) was not found in the Cloud run registry\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cloudrun/src/shared/validate-image-remotion-version.ts","lineNumber":24,"sourceCode":"\t\tprojectId: process.env.REMOTION_GCP_PROJECT_ID,\n\t\tcredentials: {\n\t\t\tclient_email: process.env.REMOTION_GCP_CLIENT_EMAIL,\n\t\t\tprivate_key: process.env.REMOTION_GCP_PRIVATE_KEY,\n\t\t},\n\t});\n\tconst listedTags = await client.listTags({\n\t\tparent:\n\t\t\t'projects/remotion-dev/locations/us/repositories/production/packages/render',\n\t});\n\n\tfor (const tag of listedTags[0]) {\n\t\tif (VERSION === tag.name?.split('/').pop()) {\n\t\t\t// if match is found, exit the function\n\t\t\treturn;\n\t\t}\n\t}\n\n\tthrow new Error(\n\t\t`The tag for Remotion version ${VERSION} was not found in the Cloud run registry.`,\n\t);\n};\n","sourceCodeStart":6,"sourceCodeEnd":28,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/cloudrun/src/shared/validate-image-remotion-version.ts#L6-L28","documentation":"Thrown by validateImageRemotionVersion() after querying the Artifact Registry (projects/remotion-dev/.../repositories/production/packages/render) for tags and finding none equal to the installed package VERSION. The check ensures the Docker image tag for your @remotion/cloudrun version exists before attempting to deploy a service from it. A missing tag usually means a prerelease, yanked, or not-yet-published version.","triggerScenarios":"Calling deployService() (or any flow that calls validateImageRemotionVersion) with an @remotion/cloudrun version whose image tag was never published to the registry — e.g., a local build, a canary, or a version newer than the latest published image.","commonSituations":"Running a local/linked build of @remotion/cloudrun with a bumped version not yet released; using a prerelease tag; the registry was not yet updated when you upgraded.","solutions":["Install a published release: `npm i @remotion/cloudrun@latest` then redeploy.","Wait for the image tag to be published if you are tracking a freshly released version.","If you are a Remotion contributor testing a local version, build and push the image yourself or use a pinned released version."],"exampleFix":"// before: local bump to 5.0.0-canary not in registry\n// $ npm i @remotion/cloudrun@5.0.0-canary.abcdef\n// $ npx remotion cloudrun services deploy\n// after: use a published release\n// $ npm i @remotion/cloudrun@latest\n// $ npx remotion cloudrun services deploy","handlingStrategy":"validation","validationCode":"import pkg from '@remotion/cloudrun/package.json';\n// Only attempt deploy on a published (non-prerelease) version\nif (pkg.version.includes('-')) {\n  throw new Error(`${pkg.version} looks like a prerelease; its image tag may not be in the registry. Use a published release.`);\n}","typeGuard":"function isLikelyPublishedRelease(version: string): boolean {\n  return /^\\d+\\.\\d+\\.\\d+$/.test(version);\n}","tryCatchPattern":"try {\n  await deployService(opts);\n} catch (err) {\n  if (err instanceof Error && err.message.includes('was not found in the Cloud run registry')) {\n    throw new Error('Image tag missing. Install a published @remotion/cloudrun release and redeploy.');\n  }\n  throw err;\n}","preventionTips":["Deploy only from published releases, not local/canary builds.","Upgrade via `npm i @remotion/cloudrun@latest` and wait for the image registry to mirror the release.","Pin versions in CI to avoid accidental canary installs."],"tags":["cloudrun","deployment","version","registry","network"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}