- install.sh: detect Darwin, use Homebrew for packages/Node, Docker Desktop hint - install.sh: portable realpath and bash 3-compatible confirm() for macOS - docs/installer-support.md: add macOS (Darwin) / Homebrew to support matrix - README.md: document supported platforms (Linux and macOS), Docker Desktop/Homebrew - ci.yml: add installer-macos job (macos-latest, bash -n install.sh) Made-with: Cursor
1.5 KiB
1.5 KiB
Installer platform support
This document defines current support status for ./install.sh.
Support states
- Stable: full tested path in CI and expected to work end-to-end.
- Scaffolded: distro is detected and actionable install guidance is provided, but full automatic package installation is not implemented yet.
- Unsupported: distro/package manager is not detected by installer.
Current matrix
| Distro family | Package manager | State | Notes |
|---|---|---|---|
| Debian / Ubuntu | apt |
Stable | Full automatic dependency install path. |
| Fedora / RHEL / CentOS | dnf / yum |
Scaffolded | Detection + actionable commands present; auto-install path is TODO. |
| openSUSE | zypper |
Scaffolded | Detection + actionable commands present; auto-install path is TODO. |
| Arch Linux | pacman |
Scaffolded | Detection + actionable commands present; auto-install path is TODO. |
| Other Linux distros | unknown | Unsupported | Installer exits with package-manager guidance requirement. |
| macOS (Darwin) | Homebrew | Stable | Docker mode requires Docker Desktop. Local mode uses Homebrew for curl, git, make, openssl, Node.js. |
Guard rails
- Debian/Ubuntu behavior must remain stable for every portability PR.
- New distro support should be added behind explicit package-manager adapters and tests.
- If a distro is scaffolded but not fully automated, installer should fail fast with actionable manual commands (not generic errors).