Core Features
This page covers the core functionality for app package migration. For migrating data within apps, see Data Migration.
Migrate Apps to External Storage
- Select a single app or long-press and drag to select multiple apps (or Cmd+click to select apps)
- Click the "Migrate to External" button at the bottom
- Wait for migration to complete
Note
At 100% migration progress, there may be a 1-2 second pause while creating local links
Updated Local Apps
If a migrated app is later reinstalled or updated locally while the external storage still contains the old copy, AppPorts marks it as "Pending Move Out" when it can confirm the version relationship. Migrating it again moves the newer local app to external storage and replaces the old external copy.
AppPorts only cleans the external target automatically when it can confirm the target is the old copy, an AppPorts-managed portal, or a stale AppPorts migration remnant. If the external location contains an unrelated real app, migration stops with a conflict instead of overwriting it.
Move External Apps Back to Local
- Select the app in the External Apps library
- Click "Move Back to Local"
Local Conflict Protection
When moving an app back, AppPorts will not overwrite a same-name real local app or a symbolic link that does not belong to the current external app. Only AppPorts-recognized local entries for the same app are removed automatically.
Link External Apps to Local
- Select the app in the External Apps library
- Click "Link to Local"
Unlink
Click the Unlink button on the right side of the linked apps list. 