When a user or admin installs this package on a target Mac, it installs RestoreTools into /usr/local/bin/ and registers a local recovery option. After installation, to restore that Mac to the exact state of the original machine’s snapshot, run:
Here is the core advantage: Instead of wiping a disk and reinstalling macOS from the internet (which can take hours), a Mac with RestoreTools installed can revert to a known-good APFS snapshot in minutes—even without network access to Apple’s servers. restoretools pkg new
sudo tmutil listlocalsnapshots / If none exist, create one manually: When a user or admin installs this package
By mastering this command, you reduce downtime from hours to minutes, lower bandwidth costs, and give end-users a reliable "reset to good" button. Whether you are building a fleet for a school, a hospital, or a creative agency, RestoreTools is the silent guardian of your Mac infrastructure. Whether you are building a fleet for a
Staying current with the latest RestoreTools GitHub commits is essential. The new flag today might include --include-ssv or --bless-firmware in future releases. If you manage more than ten Macs, you have likely experienced the pain of re-imaging a machine over a slow VPN. The restoretools pkg new workflow flips that model on its head. Instead of pushing gigabytes of data across the network, you push a lightweight package (<20 MB) that empowers each Mac to be its own recovery server.
| Error Message | Likely Cause | Solution | |---------------|----------------|-----------| | No snapshots found | No local Time Machine or APFS snapshot exists | Run sudo tmutil localsnapshot | | Operation not permitted | Terminal lacks Full Disk Access | Go to System Settings > Privacy & Security > Full Disk Access > Add Terminal | | Unsupported volume format | Trying to package a non-APFS volume (e.g., external HFS+) | Ensure you are booted from the internal APFS SSD | | Cannot locate restoretools binary | The pkg new command expects the source binary | Run the command from the directory containing restoretools or use absolute path | | Feature | Time Machine | Carbon Copy Cloner | restoretools pkg new | | :--- | :--- | :--- | :--- | | Recovery Speed | Slow (full copy) | Moderate (block copy) | Fast (snapshot revert) | | Network Dependence | Yes (for backup) | No (local disk) | No (local APFS) | | Apple Silicon Support | Limited | Full | Full | | Deployable .pkg Output | No | No | Yes | | Command-line Automation | Partial | Yes | Full | The Future: RestoreTools and macOS Sequoia As of macOS 14/15, Apple continues to lock down the boot process. However, RestoreTools remains viable because it works within the running OS, leveraging the built-in apfs kernel extensions and snapshot mechanisms. The "pkg new" command is evolving to include support for cryptex (dynamic iOS/macOS system components) and signed system volume (SSV) snapshots.