rename project to runaway

This commit is contained in:
2026-11-09 10:13:51 +08:00
parent 5857081832
commit c9feb8c05a
95 changed files with 1034 additions and 1034 deletions
+48 -48
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Commands Reference — unleash
title: Commands Reference — runaway
---
# Commands Reference
@@ -19,34 +19,34 @@ title: Commands Reference — unleash
Creates a temporary admin account and suppresses all 5 layers of MDM.
**Must run from Recovery.**
```bash
./unleash bypass
./runaway bypass
```
### `suppress`
Silences MDM enrollment without creating a new user.
Works from both Recovery and booted systems.
```bash
sudo ./unleash suppress
sudo ./runaway suppress
```
### `heal`
Re-applies suppression after macOS updates re-enable enrollment daemons.
On booted systems, needs sudo. With `persist`, runs automatically on each boot.
```bash
sudo ./unleash heal
sudo ./runaway heal
```
### `persist`
Installs a LaunchDaemon that runs `heal` automatically on every boot.
Survives macOS updates.
```bash
sudo ./unleash persist
sudo ./runaway persist
```
### `unpersist`
Removes the persistence LaunchDaemon.
```bash
sudo ./unleash unpersist
sudo ./runaway unpersist
```
---
@@ -64,20 +64,20 @@ Kernel-level packet filtering. Blocks Apple's entire IP range (`17.0.0.0/8`).
DoH-proof — cannot be bypassed by DNS-over-HTTPS.
**Warning:** Breaks iCloud, App Store, and system updates.
```bash
sudo ./unleash firewall
sudo ./runaway firewall
```
### `firewall-off`
Removes pf firewall rules added by `firewall`.
```bash
sudo ./unleash firewall-off
sudo ./runaway firewall-off
```
### `whitelist`
Resolves only MDM domains to IPs and blocks those specifically.
Keeps iCloud and App Store working while blocking MDM enrollment.
```bash
sudo ./unleash whitelist
sudo ./runaway whitelist
```
---
@@ -93,7 +93,7 @@ sudo ./unleash whitelist
Kills running MDM processes, removes configuration profiles, and flushes DNS cache.
Useful when MDM is actively enrolling on a booted system.
```bash
sudo ./unleash harden
sudo ./runaway harden
```
### `audit`
@@ -104,7 +104,7 @@ Performs a deep MDM scan:
- Searches for MDM certificates
- Generates a risk score (0–100)
```bash
sudo ./unleash audit
sudo ./runaway audit
```
---
@@ -126,7 +126,7 @@ sudo ./unleash audit
Returns **SAFE TO FORMAT** (no MDM) or **MDM DETECTED** (will lock after wipe).
Also checks upgrade safety for macOS updates.
```bash
sudo ./unleash check
sudo ./runaway check
```
### `monitor`
@@ -134,14 +134,14 @@ Background daemon that checks MDM state every 5 minutes.
Sends a macOS notification if MDM tries to re-enroll.
Supports optional `--webhook` for Discord alerts.
```bash
sudo ./unleash monitor
sudo ./unleash monitor --webhook https://discord.com/api/webhooks/...
sudo ./runaway monitor
sudo ./runaway monitor --webhook https://discord.com/api/webhooks/...
```
### `history`
Shows the event log from previous monitor and heal runs.
```bash
sudo ./unleash history
sudo ./runaway history
```
---
@@ -155,21 +155,21 @@ sudo ./unleash history
| `dualboot` | Target an external macOS install |
### `backup`
Saves `/etc/hosts`, MDM profile state, launchd disabled overrides, and Unleash config.
Saves `/etc/hosts`, MDM profile state, launchd disabled overrides, and Runaway config.
```bash
sudo ./unleash backup
sudo ./runaway backup
```
### `restore`
Reverts the system to a previously saved state.
```bash
sudo ./unleash restore
sudo ./runaway restore
```
### `dualboot`
Creates an admin account and applies suppression to an external/bootcamp volume.
```bash
sudo ./unleash dualboot
sudo ./runaway dualboot
```
---
@@ -188,35 +188,35 @@ sudo ./unleash dualboot
Interactive wizard that runs the full setup:
firewall → monitor → persist → backup → audit.
```bash
sudo ./unleash init
sudo ./runaway init
```
### `suggest`
Analyzes your system and provides risk-based recommendations.
```bash
sudo ./unleash suggest
sudo ./runaway suggest
```
### `remediate`
Per-org MDM cleanup. Supports: JAMF, Mosyle, Addigy, Kandji, VMware.
Auto-detects the org from your DEP record.
```bash
sudo ./unleash remediate
sudo ./runaway remediate
```
### `predict`
Reads the serial number prefix and checks against known MDM org prefixes.
Useful before buying a used Mac.
```bash
./unleash predict ABC12345678
./runaway predict ABC12345678
```
### `telemetry`
Manages anonymous usage stats (opt-in, OFF by default).
```bash
./unleash telemetry on
./unleash telemetry off
./unleash telemetry status
./runaway telemetry on
./runaway telemetry off
./runaway telemetry status
```
---
@@ -232,9 +232,9 @@ Manages anonymous usage stats (opt-in, OFF by default).
Designed for org-provided Macs that must enroll but should only communicate while on VPN.
Blocks MDM IPs when the device is NOT connected to your VPN tunnel.
```bash
sudo ./unleash vpn-kill
sudo ./unleash vpn-kill-status
sudo ./unleash vpn-kill-remove
sudo ./runaway vpn-kill
sudo ./runaway vpn-kill-status
sudo ./runaway vpn-kill-remove
```
---
@@ -254,40 +254,40 @@ sudo ./unleash vpn-kill-remove
### `update`
Downloads the latest release from GitHub. GPG-verifies the signature.
```bash
sudo ./unleash update
sudo ./runaway update
```
### `uninstall`
Removes all Unleash traces. Prompts for confirmation.
Removes all Runaway traces. Prompts for confirmation.
```bash
sudo ./unleash uninstall
sudo ./runaway uninstall
```
### `reinstall`
Uninstalls then re-applies persist + whitelist + monitor.
```bash
sudo ./unleash reinstall
sudo ./runaway reinstall
```
### `config`
View or edit persistent settings in `~/.unleash.conf`.
View or edit persistent settings in `~/.runaway.conf`.
```bash
./unleash config
./unleash config show
./unleash config set key value
./runaway config
./runaway config show
./runaway config set key value
```
### `report`
Generates a full status report. Supports `--json` for machine-readable output.
```bash
sudo ./unleash report
sudo ./unleash report --json
sudo ./runaway report
sudo ./runaway report --json
```
### `demo`
Runs a simulated bypass flow. No real changes are made.
```bash
./unleash demo
./runaway demo
```
---
@@ -302,9 +302,9 @@ Runs a simulated bypass flow. No real changes are made.
Sends Discord DMs when MDM activity is detected.
```bash
sudo ./unleash discord-bot <token> <userId>
sudo ./unleash discord-bot-status
sudo ./unleash discord-bot-stop
sudo ./runaway discord-bot <token> <userId>
sudo ./runaway discord-bot-status
sudo ./runaway discord-bot-stop
```
---
@@ -321,22 +321,22 @@ sudo ./unleash discord-bot-stop
Checks: root privileges, Recovery mode detection, bash version,
disk/volume availability required libraries, and internet connectivity.
```bash
./unleash doctor
./runaway doctor
```
### `status`
Shows DEP marker state, hosts file, daemon overrides.
Only works from Recovery. Use `check` or `audit` on booted systems.
```bash
./unleash status
./unleash status -d
./runaway status
./runaway status -d
```
### `test`
Dry-run mode. Simulates a command without making real changes.
```bash
./unleash test bypass
./unleash test all
./runaway test bypass
./runaway test all
```
---