> ## Documentation Index
> Fetch the complete documentation index at: https://aomilabs-victor-docs-redirect-build-overview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Common errors

> The errors you are most likely to hit while building, running, and shipping an Aomi App, each with the cause and the fix.

These are the failures contributors hit most often. Each accordion title is the literal error or symptom, so you can search this page for what you see in your terminal.

<AccordionGroup>
  <Accordion title="SDK version mismatch: plugin=X, host=Y">
    <Warning>
      `aomi-run` refuses to load a plugin whose pinned `aomi-sdk` does not match `aomi-run`'s own version. The loader gates on an exact match, so a plugin built against a different SDK never runs.
    </Warning>

    For a local run, pin the plugin's `aomi-sdk` to the version your installed `aomi-run` reports in its boot banner (the `(aomi-sdk X.Y.Z)` on the first line at startup):

    ```toml Cargo.toml theme={null}
    [dependencies]
    aomi-sdk = "=X.Y.Z"   # match the version aomi-run prints at startup
    ```

    When you go to ship, pin instead to the platform's `required_sdk_version` (see `platform.json` in the platform repo) so CI and the backend accept the build. The community platform pins a specific version, such as `=0.1.20`, which can differ from whatever `aomi-run` you have installed.
  </Accordion>

  <Accordion title="aomi-run: command not found (after installing the toolchain)">
    <Warning>
      Installing with `--features cli` alone builds only `aomi-build` and `aomi-git`. The `cli` feature does not include `aomi-run`.
    </Warning>

    Install with both features so the `dev-runtime` feature builds `aomi-run`:

    ```bash theme={null}
    cargo install --git https://github.com/aomi-labs/aomi-sdk --features cli,dev-runtime aomi-sdk
    ```
  </Accordion>

  <Accordion title="No --version flag on the binaries">
    <Warning>
      None of the three binaries (`aomi-build`, `aomi-run`, `aomi-git`) accept `--version`. Running it errors instead of printing a version.
    </Warning>

    Use `--help` to confirm an install and see the available commands:

    ```bash theme={null}
    aomi-git --help
    aomi-build --help
    aomi-run --help
    ```
  </Accordion>
</AccordionGroup>

## Next

<Card title="The CLI toolchain" href="/reference/cli-toolchain">
  The full reference for the three Rust binaries: `aomi-build`, `aomi-run`, and `aomi-git`.
</Card>