windmill-labs/windmill · error

No wmill.yaml found. Use 'wmill init' to bootstrap it.

Error message

No wmill.yaml found. Use 'wmill init' to bootstrap it.

What it means

Returned-state warning from readConfigFile: findWmillYaml walked up to the filesystem root without finding any wmill.yaml, so no workspace config could be loaded (empty SyncOptions returned). Most sync/CLI commands requiring a workspace will not behave as intended until the config exists.

Source

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

  return foundPath;
}

export function getWmillYamlPath(): string | null {
  return findWmillYaml();
}

let legacyConfigWarned = false;

export async function readConfigFile(opts?: { warnIfMissing?: boolean }): Promise<SyncOptions> {
  const warnIfMissing = opts?.warnIfMissing ?? true;
  try {
    // First, try to find wmill.yaml recursively
    const wmillYamlPath = findWmillYaml();

    if (!wmillYamlPath) {
      if (warnIfMissing) {
        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(

View on GitHub (pinned to e474e8803c)

Solutions

1. Run 'wmill init' to bootstrap a wmill.yaml in the project root
2. Or place an existing wmill.yaml in the working directory / an ancestor
3. Suppress with warnIfMissing: false when the command tolerates missing config

When it happens

Trigger: Thrown at cli/src/core/conf.ts:211 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/5c3056227b50fe9c. Report an issue: GitHub.