windmill-labs/windmill · error

❌ The 'overrides' field is no longer supported. The confi

Error message

❌ The 'overrides' field is no longer supported.
   The configuration system now uses workspace-based configuration.
   Please delete your wmill.yaml and run 'wmill init' to recreate it with the new format.

What it means

Error "❌ The 'overrides' field is no longer supported. The configuration system now uses workspace-based configuration. Please delete your wmill.yaml and run 'wmill init' to recreate it with the new format." thrown in windmill-labs/windmill.

Source

Thrown at cli/src/core/conf.ts:229

        log.warn(
          "No wmill.yaml found. Use 'wmill init' to bootstrap it."
        );
      }
      return {};
    }

    const conf = (await yamlParseFile(wmillYamlPath)) as SyncOptions;

    // Handle obsolete overrides format
    if (conf && "overrides" in conf) {
      const overrides = conf.overrides as any;
      const hasSettings =
        overrides &&
        typeof overrides === "object" &&
        Object.keys(overrides).length > 0;

      if (hasSettings) {
        throw new Error(
          "❌ The 'overrides' field is no longer supported.\n" +
            "   The configuration system now uses workspace-based configuration.\n" +
            "   Please delete your wmill.yaml and run 'wmill init' to recreate it with the new format."
        );
      } else {
        delete conf.overrides;
      }
    }

    // Normalize legacy formats to `workspaces` in memory (no file rewrite).
    // Priority: workspaces > gitBranches > environments > git_branches
    if (conf && !conf.workspaces) {
      let legacyKey: string | null = null;
      let legacyData: LegacyBranchesConfig | undefined;

      if (conf.gitBranches) {
        legacyKey = "gitBranches";
        legacyData = conf.gitBranches;

View on GitHub (pinned to e474e8803c)

Solutions

1. Delete wmill.yaml and run `wmill init` to recreate it in the workspace-based format.
2. Migrate any needed values from the old overrides block into the new workspace-based settings manually.

When it happens

Trigger: Thrown at cli/src/core/conf.ts:229 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of windmill-labs/windmill@e474e8803c (2026-09-03). Data as JSON: /api/errors/c79ce4ae6a7a28fe. Report an issue: GitHub.