EscapeOS

EscapeOS can be installed on compatible iPhones without a traditional jailbreak.

Its official setup uses iPASide on Windows, a pairing file, and LocalDevVPN.

Before installing EscapeOS

1. Open Settings → General → About.
2. Check your iPhone's exact iOS version.
3. Confirm that your firmware supports the required bad_query method.
4. Back up important iPhone data.
5. Prepare a Windows computer.
6. Install a compatible version of iPASide.
7. Keep your iPhone unlocked during the initial pairing process.
8. Connect to a stable Wi-Fi network.
9. Install LocalDevVPN on your iPhone.
10. Download the official EscapeOS IPA.

How to download EscapeOS IPA

1. Open the pwnapplehat/EscapeOS GitHub repository.
2. Select Releases.
3. Open version v0.3.2.
4. Read the release notes and testing warnings.
5. Download the EscapeOS IPA from the release assets.
6. Save the file on your computer.
7. Open iPASide.
8. Connect your iPhone using USB.
9. Select the iPhone in iPASide.
10. Import the EscapeOS IPA.
11. Complete the sideloading process.
12. Trust the developer profile if required.
13. Enable Developer Mode if requested.

How to create the EscapeOS pairing file

EscapeOS needs a pairing record to identify installed apps and communicate with the iPhone.

1. Open iPASide on your Windows computer.
2. Connect your iPhone.
3. Unlock the device.
4. Accept the Trust This Computer prompt.
5. Open iPASide's pairing settings.
6. Generate the required pairing record using the supported process.
7. Place pairingFile.plist into EscapeOS.
8. Confirm that iPASide reports success.
9. Disconnect USB after the setup is complete.

iPASide normally places the pairing file automatically after sideloading EscapeOS.

If you reinstall EscapeOS, you may need to place the file again.

How to import a pairing file from iLoader

EscapeOS also supports a compatible iLoader pairing record.

1. Generate the pairing file with iLoader.
2. Save it securely.
3. Transfer it to your iPhone.
4. Open EscapeOS.
5. Find the pairing file import option.
6. Select the saved record.
7. Confirm the import.
8. Connect LocalDevVPN.

The imported file must contain the information required by your iOS version.

How to connect LocalDevVPN

1. Install LocalDevVPN on your iPhone.
2. Open the application.
3. Configure the supported local connection.
4. Connect LocalDevVPN.
5. Keep Wi-Fi enabled.
6. Open EscapeOS.
7. Allow the app list to load.
8. Select an installed application.

EscapeOS uses the local connection to talk to the same iPhone. It does not require an active USB connection while browsing files.

How to browse iPhone app data

1. Open EscapeOS.
2. Make sure LocalDevVPN is connected.
3. Open Apps.
4. Browse the installed app list.
5. Search for an application by name or bundle ID.
6. Select the app.
7. Open its available Data container.
8. Browse Documents, Library, or tmp.
9. Select a supported file.
10. Use the available options to preview, edit, copy, move, or share it.

How to back up app data

1. Close the application you want to back up.
2. Open EscapeOS.
3. Select the application.
4. Choose the backup option.
5. Review the backup destination.
6. Check available storage.
7. Start the backup.
8. Wait for completion.
9. Review the saved archive.
10. Export a separate copy if necessary.

Version 0.2.1 supports larger backups using streamed ZIP64 archives.

How to restore an app backup

1. Close the target application.
2. Open EscapeOS.
3. Select the Backups section.
4. Choose a saved backup.
5. Review the application and backup details.
6. Select the restore option.
7. Choose the available complete or selective restoration method.
8. Confirm which files will be replaced.
9. Start restoring.
10. Wait until verification finishes.
11. Open the target app to check its data.

Restoring application files may overwrite newer data. Keep a second backup before attempting a restore.

How to clean app caches

1. Close the selected app.
2. Open EscapeOS.
3. Select Reclaim.
4. Review applications sorted by reclaimable storage.
5. Choose an application.
6. Check the safe cache and temporary file categories.
7. Start Reclaim Space.
8. Wait until cleanup finishes.
9. Review the storage result.

The Safe reclaim option avoids Documents, Preferences, and Application Support.

Session cleanup, including some cookies and web storage, requires separate permission and may sign you out of apps.

How to reset app data

1. Close the app you want to reset.
2. Open EscapeOS.
3. Select the app from the list.
4. Open App Detail.
5. Choose Reset App Data.
6. Read the warning carefully.
7. Confirm only if you want to remove the app's local data.
8. Reopen the app and complete any necessary setup.

Reset App Data empties the selected application's Documents, Library, and tmp folders.

It does not clear the app's Keychain entries or unrelated App Groups.

How to extract archives

1. Open an accessible app folder.
2. Select a supported archive.
3. Choose Extract.
4. Enter a password if the archive requires one.
5. Allow the extraction to finish.
6. Open the extracted folder.

EscapeOS supports several archive formats, including ZIP, 7z, TAR, GZIP, BZIP2, XZ, and DEB.

RAR extraction is not included.

How to use Trash in EscapeOS

Version 0.2 introduces an experimental Trash system.

1. Open the file browser.
2. Select a file.
3. Choose Delete.
4. Confirm moving the file to Trash.
5. Open Settings → Trash when needed.
6. Review previously deleted files.
7. Restore a file to its original location if possible.

The developer has not yet completed physical-device testing for the 0.2.x interface.

How to edit SQLite databases

Version 0.2 adds a SQLite viewer and editor for supported database files.

1. Close the app that owns the database.
2. Open EscapeOS.
3. Browse to an accessible .db, .sqlite, or .sqlite3 file.
4. Open the SQLite editor.
5. Review available tables.
6. Create a backup before changing values.
7. Make only changes you understand.
8. Save the edited copy.
9. Allow the app to verify the original database has not changed.
10. Test the associated app.

SQLite editing is experimental and has not yet been confirmed through complete on-device testing.

Safety information

EscapeOS can modify important application files.

Never reset app data unless you intend to lose the app's local documents and settings.

Keep a backup outside the device before trying experimental features.

Do not share your device pairing file with untrusted websites or users.

EscapeOS combines application data browsing, backup tools, cache management, and experimental advanced file editing.

No Traditional Jailbreak

Access selected application data containers without installing a traditional jailbreak.

bad_query Sandbox Escape

Use the bad_query technique to access supported application Data containers.

Installed App List

Display apps installed on the iPhone.

Search by App Name

Find an application quickly by its name.

Search by Bundle Identifier

Locate an app through its bundle ID.

Alphabetical App Index

Jump through the application list using A–Z shortcuts.

Application Favorites

Save selected applications for quick access.

Whole-App File Search

Search for files or folders inside a supported app's data.

Documents Folder Access

Browse supported Documents folders.

Library Folder Access

Explore accessible application Library data.

Temporary Folder Access

Manage supported files in an application's tmp folder.

File Preview

Open supported files for viewing.

Text Editing

Edit compatible text files inside accessible folders.

Hex Viewer

Inspect supported files as hexadecimal data.

File Copy and Paste

Copy files within supported application containers.

File Cut and Move

Move selected files where permissions allow.

Duplicate Files

Create copies of supported files.

Rename Files

Change file names in writable locations.

Import from Files

Import files from Apple's Files app.

Replace or Keep Both

Choose what happens when an imported or pasted file has the same name as an existing item.

File Sharing

Share compatible files using the system share sheet.

ZIP Compression

Create ZIP archives from supported files and folders.

ZIP Extraction

Extract files from ZIP archives.

7z Archive Extraction

Open supported 7z archives, including certain encrypted archives.

TAR and DEB Extraction

Extract supported TAR and DEB archives.

Encrypted Archive Support

Enter passwords for supported encrypted ZIP and 7z files.

App Data Backups

Create copies of supported application data.

Backup Export

Save or share backups as ZIP archives.

App Data Restore

Restore saved application data.

Large Backup Support – v0.2.1

Remove the previous 5,000-file and 512 MB backup limits.

ZIP64 Backup Archives – v0.2.1

Support backup archives with very large files or large numbers of entries.

Streaming Backups – v0.2.1

Write backed-up files in smaller pieces to reduce memory usage.

Verified File Restoration – v0.2.1

Verify restored files before replacing their existing versions.

Partial Backups – v0.2.0

Back up selected files and folders instead of the entire app data container.

Selective Restore – v0.2.0

Choose individual files to restore from a saved backup.

Trash System – v0.2.0

Move deleted files to a recoverable Trash area.

Restore Deleted Files – v0.2.0

Restore supported items without automatically overwriting existing files.

Drag and Drop – v0.2.0

Import supported files and folders from the Files app.

Multiple File Sharing – v0.2.0

Share several selected files through one share action.

Transfer Progress – v0.2.0

Review progress for supported longer file operations.

Operation Queue – v0.2.0

Run lengthy file operations one after another.

SQLite Viewer – v0.2.0

Browse tables in supported SQLite databases.

SQLite Editor – v0.2.0

Edit supported database values through a copy-and-verify process.

Reclaim Space

Find supported caches and temporary data that may be safely removed.

Safe Cache Cleanup

Remove selected temporary files without clearing Documents or Preferences.

Optional Session Cleanup

Clean selected cookies and session data with an additional confirmation.

Reset App Data

Remove local Documents, Library, and tmp contents from a selected app.

LocalDevVPN Integration

Use a local VPN connection for app discovery.

iPASide Pairing Support

Create and place the pairing record through iPASide.

iLoader Pairing File Import

Import compatible pairing files created with iLoader.

No Computer After Setup

Use EscapeOS without an active USB connection after successful initial pairing.

Supported iOS Versions

1. iOS 15–17: Unsupported.
2. iOS 18: Installable, but file access has not been verified.
3. iOS 26.0–26.3: Within bad_query range; some discovery methods untested.
4. iOS 26.4–26.6.1: Main documented compatibility range.
5. iOS 26.5.1: Hardware-tested.
6. iOS 26.7 and newer: Unsupported.
7. iOS 27.0 beta 4: Within bad_query range but untested.
8. iOS 27.0 beta 5 and later: Unsupported.

EscapeOS vs Filza

Filza is a general-purpose file manager often used with jailbreak or TrollStore permissions.

EscapeOS focuses on accessible App Store application Data containers using LocalDevVPN and bad_query.

EscapeOS vs WQFiles

Both provide advanced app data management without a traditional jailbreak.

However, their supported exploits, pairing requirements, backup implementations, and firmware ranges differ.

EscapeOS vs FilzaSlop

FilzaSlop uses its own experimental file-access techniques.

EscapeOS uses the developer-documented bad_query method to access selected application Data containers.

EscapeOS vs iLoader

iLoader can generate a compatible pairing record.

EscapeOS uses that record for application discovery and file management.

Important Limitations

EscapeOS does not provide unrestricted root access.

It cannot access Keychain data.

It cannot browse other applications' App Groups.

It cannot access protected system paths such as /var/mobile.

It cannot browse another application's signed .app bundle.

The newest 0.2.x features have not completed physical iPhone testing.

Incorrect file changes may break applications or remove important local data.

If EscapeOS is not installing, displaying applications, backing up data, or connecting to LocalDevVPN, check these common issues.

EscapeOS IPA Is Not Installing

Confirm that your iPhone runs iOS 18 or later and that the signing process completed successfully.

EscapeOS Is Not Opening

Check the signing certificate and whether the app was installed correctly through iPASide.

No Apps Found

Make sure LocalDevVPN is connected and the pairing file is available.

Pairing File Is Missing

Use iPASide → Settings → Pairing file → Place.

Pairing File Disappeared After Reinstalling

Reinstalling EscapeOS may require you to place the pairing record again.

InvalidHostID Error

The iPhone does not recognize the current pairing record.

Create a fresh pairing file using the correct device and import it again.

LocalDevVPN Is Not Connecting

Check its configuration, Wi-Fi, and whether another VPN is interfering.

LocalDevVPN Connects but Apps Are Missing

Check whether the pairing file contains the required Remote Pairing information.

iOS 26 Remote Pairing Fails

On iOS 26.4–26.6.1, the app needs a pairing record that includes Remote Pairing keys.

A basic lockdown-only file may fail.

Unable to Open App Data

The firmware may not support bad_query, or the selected container may be protected.

EscapeOS Is Not Working on iOS 26.7

iOS 26.7 is outside the supported bad_query range.

EscapeOS Is Not Working on iOS 27.2

The developer does not support this firmware.

EscapeOS Is Not Working on iOS 27.3

The required sandbox escape is not documented as working on this firmware.

EscapeOS Is Not Working on iOS 18

The IPA can install, but advanced file access has not been verified on iOS 18.

Permission Denied

The selected file may still have filesystem restrictions.

App List Is Slow

Check LocalDevVPN and allow the device discovery process to finish.

Import from Files Fails

Use version 0.1.8 or later. That release fixes an import path problem.

Duplicate File Name

Choose Replace, Keep Both, or Cancel when available.

Archive Extraction Fails

Check the file format, password, and available storage.

RAR Archive Does Not Open

RAR extraction is not included in EscapeOS.

File Backup Fails

Close the target app and confirm that enough free storage is available.

Safety Limit Exceeded

Version 0.2.1 removes the previous file-count and backup-size limits.

Large Backup Crashes

The latest version improves streaming backups, but its new functionality still needs physical-device testing.

Backup Restore Fails

Check that the archive is complete and the destination app is closed.

Trash Is Missing

The Trash feature was introduced in version 0.2.0.

SQLite Database Cannot Be Edited

The file may be protected, unsupported, or actively used by another app.

Reclaim Space Does Not Free Storage

The cache may contain protected files, or the application may recreate temporary data.

Reset App Data Deleted My Files

Reset App Data intentionally removes local Documents, Library, and tmp files.

Restore a separate backup if available.

EscapeOS Cannot Access Keychain

Keychain access is not supported by the project.

EscapeOS Cannot Access App Groups

Access to unrelated applications' App Groups is not supported.

Safety Tips

Close apps before editing their data.

Keep separate backups.

Protect your pairing file.

Do not experiment with sensitive application databases on your primary device.

Use the official GitHub release and read the developer's testing warnings.