docs: record macOS 27 reports and Wi-Fi investigation steps

This commit is contained in:
2026-10-30 11:48:40 -03:00
parent e1dbc8f5e1
commit eca2592797
3 changed files with 52 additions and 13 deletions
+50 -11
View File
@@ -283,16 +283,20 @@ Unleash blocks via `/etc/hosts`:
- `acmdm.apple.com` — Apple Configurator MDM - `acmdm.apple.com` — Apple Configurator MDM
- `axm-adm-mdm.apple.com` — ACM enrollment - `axm-adm-mdm.apple.com` — ACM enrollment
- `albert.apple.com` — ABM device assignment - `albert.apple.com` — ABM device assignment
- `gdmf.apple.com` — MDM framework - `gdmf.apple.com` — software update catalog
- `configuration.apple.com` — config service
- `xp.apple.com` — device management - `xp.apple.com` — device management
- `gs.apple.com` — device enrollment - `gs.apple.com` — software updates
- `tb.apple.com` — device trust - `tb.apple.com` — device trust
- `vpp.itunes.apple.com` — volume purchase - `vpp.itunes.apple.com` — volume purchase
- Your org's MDM host (extracted from the DEP record) - Your org's MDM host (extracted from the DEP record)
Both IPv4 (0.0.0.0) and IPv6 (::) entries are added. Both IPv4 (0.0.0.0) and IPv6 (::) entries are added.
Some listed hosts also serve general Apple services. Blocking the software-update
hosts can affect updates; this is distinct from a Wi-Fi radio failure.
`configuration.apple.com`, used for Rosetta 2 updates, is no longer blocked.
See [Apple's network requirements](https://support.apple.com/en-gb/101555).
### Layer 3: Launchd daemon override ### Layer 3: Launchd daemon override
macOS registers enrollment daemons that run at boot: macOS registers enrollment daemons that run at boot:
@@ -464,17 +468,51 @@ Unleash checks for `/private/var/db/dslocal/nodes/Default` on the mounted volume
### macOS 27 and later ### macOS 27 and later
macOS 27 has no recorded passing hardware validation in this project yet. [#22](https://github.com/mateussiqueira/unleash/issues/22) contains two positive
Compatibility is tracked in [#22](https://github.com/mateussiqueira/unleash/issues/22). community reports for macOS 27.2:
For a compatibility or Wi-Fi report, collect the build and interface state:
- The [original reporter](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6522921874)
reports Unleash 2.0.0 working on an M1 Pro after upgrading an existing Sequoia
setup. This was not a fresh installation.
- [Another user](https://github.com/mateussiqueira/unleash/issues/22#issuecomment-6520816615)
reports basic commands working on a MacBook Neo (Apple A18 Pro).
These reports answer the original question but do not establish support for every
build, command, or Recovery/FileVault scenario. Neither includes a complete test
matrix. Shell regression tests are separate from hardware validation.
### Wi-Fi on an external startup disk
[#24](https://github.com/mateussiqueira/unleash/issues/24) remains under
investigation. From the affected external installation, run:
```bash ```bash
./unleash doctor --network ./unleash doctor --network
``` ```
This reads the macOS build, Wi-Fi interface, power, and link status. Include This read-only command reports the macOS build, Wi-Fi interface, power, link, and
the script commit, hardware model, and external SSD/hub connection when IPv4 category without printing SSIDs, hardware addresses, or IP addresses.
reporting an external-volume problem. It does not certify compatibility. A failed query is reported separately from a successful query with no Wi-Fi port.
- `Link status: inactive` concerns the interface link, before internet reachability.
- `Wi-Fi IPv4: link-local` indicates a 169.254 address; `none` means no nonzero IPv4
address was reported. Neither result diagnoses IPv6 connectivity.
- `Wi-Fi IPv4: configured` does not prove DNS or internet access.
Include the script commit, Mac model, exact OS build, SSD/cable/hub connection,
and whether Wi-Fi worked on that same external installation before running
Unleash, if known. Working Wi-Fi on the internal installation alone does not
isolate what changed on the external one.
The `dualboot` code does not directly rewrite Wi-Fi preferences or toggle the
radio. Tests preserve simulated network preferences, but do not reproduce macOS
services reacting to account, enrollment, or boot changes.
Apple documents [model-specific external installations](https://support.apple.com/en-eg/111336)
and possible [USB 3/Thunderbolt 3 wireless interference](https://support.apple.com/en-us/102319).
These are investigation leads, not confirmed causes of #24. If comparing startup
disk cables or hubs, shut down before changing their connections; do not unplug
the active startup disk.
### Monitor won't start ### Monitor won't start
Check if it's already running (`monitor-status`). Check permissions — it needs root. Check logs at `/var/log/unleash-monitor.log`. Check if it's already running (`monitor-status`). Check permissions — it needs root. Check logs at `/var/log/unleash-monitor.log`.
@@ -483,8 +521,9 @@ Check if it's already running (`monitor-status`). Check permissions — it needs
**What macOS versions are supported?** **What macOS versions are supported?**
The existing targets are macOS 12–15 and 26. Validation depends on the command, The existing targets are macOS 12–15 and 26. Validation depends on the command,
OS build, and hardware; macOS 27 remains unverified. Shell regression tests OS build, and hardware. macOS 27.2 has the limited community reports described
do not replace testing Recovery, FileVault, and networking on the target Mac. above; they do not replace testing Recovery, FileVault, and networking on the
target Mac.
**Do I need to disable SIP?** **Do I need to disable SIP?**
No. All writes target the Data volume. No. All writes target the Data volume.
+1 -1
View File
@@ -6,7 +6,7 @@ _network_diagnostics() {
build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable
fi fi
printf 'macOS: %s (build %s)\n' "$version" "$build" printf 'macOS: %s (build %s)\n' "$version" "$build"
case "$version" in 27.*) warn "macOS 27 hardware compatibility remains unverified (issue #22)." ;; esac case "$version" in 27.*) warn "macOS 27 has limited community reports; see issue #22 for their scope." ;; esac
local interface ports local interface ports
if ! command -v networksetup >/dev/null; then if ! command -v networksetup >/dev/null; then
warn "Wi-Fi diagnostics unavailable: networksetup is missing." warn "Wi-Fi diagnostics unavailable: networksetup is missing."
+1 -1
View File
@@ -1904,7 +1904,7 @@ _network_diagnostics() {
build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable build=$(sw_vers -buildVersion 2>/dev/null) || build=unavailable
fi fi
printf 'macOS: %s (build %s)\n' "$version" "$build" printf 'macOS: %s (build %s)\n' "$version" "$build"
case "$version" in 27.*) warn "macOS 27 hardware compatibility remains unverified (issue #22)." ;; esac case "$version" in 27.*) warn "macOS 27 has limited community reports; see issue #22 for their scope." ;; esac
local interface ports local interface ports
if ! command -v networksetup >/dev/null; then if ! command -v networksetup >/dev/null; then
warn "Wi-Fi diagnostics unavailable: networksetup is missing." warn "Wi-Fi diagnostics unavailable: networksetup is missing."