rename project to runaway
This commit is contained in:
+48
-48
@@ -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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user