Skip to content
Latchkey

Unity "No valid Unity Editor version found" in GameCI

GameCI picks the editor image from your project ProjectVersion.txt or the unityVersion input. If that version has no published unityci/editor image, the job cannot find an editor to run.

What this error means

The builder fails before activation with "No valid Unity Editor version found" or a Docker pull error for unityci/editor:<version> that does not exist.

unity
Error: No valid Unity Editor version found for 2022.3.99f1.
manifest for unityci/editor:ubuntu-2022.3.99f1-... not found

Common causes

The exact version has no prebuilt image

GameCI publishes images for released editor versions. A typo, an unreleased version, or a brand-new patch with no image yet cannot be pulled.

ProjectVersion.txt and the input disagree

A mismatch between ProjectSettings/ProjectVersion.txt and the unityVersion input points GameCI at a version that has no image.

How to fix it

Pin a version that has an image

  1. Read the exact m_EditorVersion in ProjectSettings/ProjectVersion.txt.
  2. Confirm a matching unityci/editor tag exists for that version.
  3. Set unityVersion to that value (or to auto to read it from the project).
.github/workflows/ci.yml
- uses: game-ci/unity-builder@v4
  with:
    unityVersion: 2022.3.21f1
    targetPlatform: StandaloneLinux64

Upgrade the project to a published version

If you need a version with no image yet, bump the project to the nearest released patch that GameCI publishes.

How to prevent it

  • Keep ProjectVersion.txt on a released editor version.
  • Verify the unityci/editor tag exists before pinning it.
  • Use unityVersion: auto to read the version from the project.

Related guides

Tired of flaky CI? Latchkey auto-heals failed jobs and retries them for you. Start free →