Check that your Mac is ready
Verify the small host requirements for the Oore CLI and your selected device role.
The Oore bootstrap needs a supported Mac, internet access, and standard macOS command-line tools.
You do not need a project, Flutter, FVM, Xcode, or Android Studio to install Oore.
Bootstrap requirements
- Use macOS on an
arm64orx86_64processor. - Use a normal macOS account.
- Allow HTTPS access to the Oore release index and GitHub Releases.
- Keep
curl,tar,lockf,ssh-keygen, and eithershasumorsha256sumavailable.
Run these commands to verify the host:
uname -s
uname -m
command -v curl tar lockf ssh-keygen
command -v shasum || command -v sha256sumThe first command must print Darwin. The second command must print arm64 or x86_64.
Requirements by device role
Choose a role during oore install.
| Role | Extra host requirements |
|---|---|
| Complete | Administrator access for services. Add Git and platform tools before builds that need them. |
| Control plane | Administrator access for the control-plane service. |
| Runner | Administrator access for the runner service. Add Git and platform tools before builds that need them. |
| Web node | Administrator access for the web service. |
| CLI only | No service permission or local build toolchain. |
SSH sessions are supported. Oore automatically uses terminal setup over SSH.
Flutter and platform tools
When the first Flutter build starts, Oore prepares its managed Flutter tooling.
If .fvmrc exists, the runner uses it. Otherwise, it uses flutter_version from .oore.yaml.
If neither file selects a version, Oore uses its managed stable Flutter version.
Install platform tools only on runners that need them:
- Before any repository build, install Git.
- For Android builds, install a JDK and the Android SDK.
- For iOS or macOS builds, install Xcode.
- For signed Apple artifacts, provide the required signing material.
Oore reports missing build tools for the affected build. Their absence does not block CLI or control-plane setup.