c402344cb8
- 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
27 lines
1.5 KiB
Markdown
27 lines
1.5 KiB
Markdown
# 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).
|