All guides
Erosion · Install guide12 min readIntermediate9 stepsUpdated 2026-11-16

Set up Erosion on iPhone

Sign the IPA, get past the App Group check, and apply your first PosterBoard wallpaper in nine steps.

v0.3.1iPhone / iPadNo computer needed

Back up and sign correctly

Erosion changes system-level files. Back up the device first, and sign the IPA with a working App Group profile — the upstream release notes warn that paid or enterprise certificates can break App Groups.

On this page
01

Check compatibility

Confirm the iOS version before signing anything.

  • iOS / iPadOS 26.0 – 26.6.2: wallpaper and customization features work, but MobileGestalt tweaks do not.
  • iOS / iPadOS 27.0 – 27.2.1: full feature set.
  • iOS 27.3 beta 1 (24C5037i): supported by the project.
  • Any other version is unsupported. Do not ask for extended support.

Version check

Open Settings → General → About and read the software version. If it is not listed above, stop here.

02

Back up your iPhone

Erosion touches system data and the project warns data loss is possible.

  • Make a full iCloud backup, or connect to Finder / iTunes and create a local backup.
  • Confirm the backup finished before installing anything.
  • Keep the device unlocked and trusted during setup.
03

Sign the IPA

A certificate works, but App Group signing is the fragile part.

Erosion needs the App Group entitlement to reach its container. The upstream release notes say paid or enterprise certificates may sign App Groups incorrectly, so a certificate is not always the most reliable option.

  • Certificate path: sign the IPA with a profile that includes App Groups, install it, and trust the developer profile.
  • If App Group signing fails with a paid certificate, re-sign with SideStore or Impactor using your own Apple ID.
  • Do not install with a different bundle identifier — the app depends on its original App Group.

App Group alert

On launch, Erosion checks its custom App Group ID. If it falls back to the default and shows an alert, tweaks will not work — re-sign with a valid App Group profile.

04

Install and trust the app

Finish the install and let iOS trust the signer.

  • Install the signed IPA with your signing tool.
  • Open Settings → General → VPN & Device Management and trust the developer profile.
  • Enable Developer Mode and restart if iOS asks for it.
  • Open Erosion from the Home Screen.
05

First launch

The first run prepares container access and can look frozen.

Opening Custom Wallpapers or Dialer Themer for the first time starts app-container detection. It takes about 30 seconds, shows a progress indicator in current builds, and only runs once.

  • Keep the app open while the first detection finishes.
  • If the App Group alert appears, stop and re-sign instead of continuing.
  • Do not force-quit during the initial container scan.
06

Import a wallpaper

Use the on-device library or import a .tendies package.

  • Open the Custom Wallpapers section.
  • Choose a .tendies file downloaded from this site, or pick one from the in-app library.
  • Apply the wallpaper and wait for the respring to finish.
  • Open the lock-screen wallpaper editor and select the new wallpaper from Favorites.

Dialer themes

The same container access powers Dialer Themer. Set a theme only after the first container detection has completed.

07

Apply and respring

Applying writes the wallpaper descriptor and restarts the UI.

  • Wait for Erosion to report success before closing it.
  • If the wallpaper does not appear, run Reset Collections and apply again.
  • Reboot the phone if the respring does not complete.
08

Explore tweaks carefully

Change one group at a time so you can revert it.

  • Supported status bar and SpringBoard options work on iOS 27; iOS 26 has fewer options.
  • MobileGestalt tweaks remain unavailable on iOS 26.
  • Apply one change, verify it, then continue — this keeps rollback simple.
09

Troubleshoot common errors

Match the symptom to the fix before reinstalling.

  • App Group alert or tweaks do nothing: re-sign with SideStore / Impactor using your own Apple ID.
  • Wallpaper missing from Favorites: run Reset Collections, re-import, apply, and respring.
  • App hangs on Custom Wallpapers: wait about 30 seconds for the first container scan.
  • App will not install: confirm the iOS version is supported and the signing profile is valid.
  • Boot loop or unexpected data loss: restore the backup from step 2 and stop applying changes.

Frequently asked questions

Next steps