---

✨ Introduction

Keep your Mac's internal storage free for what you are working on. AppPorts is a free, open-source macOS app that moves large applications, app data, and tool directories to external storage.

After migration, the full application lives on the external drive while a lightweight Stub Portal stays on your Mac. It keeps the familiar icon without a shortcut arrow. With the drive connected, you can continue opening apps from Finder, the Dock, or the system's app launcher. The migration method depends on the app, macOS version, and storage conditions.

Apps are only part of the picture. WeChat chat history, photos, videos, received files, and other suitable container data can move through APFS mount migration: the app reads from its original path, and its original signature stays intact. Suitable ordinary data folders, developer tool directories, and custom folders use symbolic links.

⚠️ "AppPorts" is damaged and can't be opened

If an official download of AppPorts shows a “damaged” warning on first launch, Gatekeeper may be blocking an unsigned or unnotarized build. After confirming the source is trustworthy and moving AppPorts into Applications, remove its quarantine attribute and try again:

xattr -rd com.apple.quarantine /Applications/AppPorts.app

If a different app stops opening after migration, check the drive connection, data mount status, and signature first. For problems caused by older re-signing methods, follow the macOS 27 upgrade and repair guide.

📸 Screenshots

🚀 Key Features

• 📦 Arrow-Free Migration: Move large apps to an external drive and keep lightweight local launchers with familiar icons. View local and external apps side by side, and synchronize existing Dock shortcuts when migrating or restoring.
• 🛡️ Auto-Update Protection: Detect Sparkle, Electron, and other update mechanisms. Offer locked migration for suitable apps to protect external copies. Unlock before updating; network volumes do not use these local file locks.
• ✍️ Code Signature Management: Check signature status and offer repair steps for apps marked “Signature replaced.” Save complete original-app backups and restore original signatures when supported. Default mode refuses to re-sign sandboxed apps.
• 🔴 Orphaned Link Detection: Mark unavailable targets so you can check the drive connection, locate missing apps, or clean up leftover launchers.
• 🍎 macOS 15.1+ App Store Support: Work with native external installation and in-place updates for eligible App Store apps, subject to the system's location and format requirements.
• ↩️ Restore Anytime: Connect the original drive and restore apps or data when your Mac has enough space. Check running apps and name conflicts before operations; attempt recovery on failure, retaining copies and reporting their locations when recovery cannot safely finish.
• 📊 Data Directory Management: Browse associated app data in grouped trees, search and sort directories, and choose whether to show zero-byte folders. Also manage tool directories such as ~/.npm and folders you select yourself.
• 💾 APFS Container Migration: Mount dedicated external APFS volumes at the original paths of suitable Containers and Group Containers data, preserving app signatures. Check for unencrypted APFS storage, connectivity, and available space before migration; mount, unmount, restore, or reconnect data afterward.
• 📐 Clearer Space Totals: Distinguish local data that can be moved from data already migrated. Avoid counting parent and child directories twice, and flag incomplete totals when reads fail.
• 🔎 Readiness Checks: Check Full Disk Access, app management, and external storage. Show the running app's version and path to help verify which copy has permission.
• 🎨 Modern UI: Native SwiftUI with Dark Mode, animated directory expansion, and a resizable information panel.
• ♿️ Accessibility: VoiceOver labels, keyboard shortcuts, and a Braille language option.
• 🌍 Global Ready: 20+ languages including English, Chinese, Japanese, Korean, German, French, Spanish, Italian, Portuguese, Russian, Arabic, Hindi, Vietnamese, Thai, Turkish, Dutch, Polish, Indonesian, Esperanto, Braille, and 👽 Martian.

🏆 Why AppPorts?

Move the storage. Keep the familiar experience. AppPorts uses a Stub Portal to retain a lightweight local launcher, with migration status, update protection, signature checks, and restoration in one interface. Manage apps and their data separately to free space where you need it.

Container data uses APFS mount migration; suitable ordinary directories retain symbolic links. Background components, permissions, and update mechanisms can affect compatibility. See limitations.

🧭 Migration Strategy

AppPorts selects a migration method based on the app type, update behavior, and data directory:

Classic data migration mode is off by default. It retains older container symlink and sandboxed-app re-signing behavior, with compatibility depending on the app and macOS version. APFS mount migration is the recommended default; keep container data locally if the drive does not meet its requirements.

Before upgrading to macOS 27, update and open AppPorts once so it can update any installed background re-signing script. On macOS 27 and later, login re-signing is disabled and old tasks are cleaned up; retry from Settings if cleanup fails. For affected apps, follow the repair guide: restore container data migrated through older symbolic links first, then restore the original signature or reinstall from an official source. Updating AppPorts does not automatically convert old migrations or restore replaced signatures.

🛠️ Installation

System Requirements

• macOS 12.0 (Monterey) or newer, on Apple Silicon or Intel Macs.
• A stable external SSD with enough free space is recommended. Format requirements depend on the migration method.
• Container mount migration currently requires unencrypted APFS external storage. Older systems may require administrator authorization and opening AppPorts to mount data after login.

Download and Installation

Download the latest AppPorts.dmg from the official website or Releases.

Move AppPorts into Applications, open it, and follow the setup checks. Connect your drive, choose an external app library, and quit the app you intend to move before starting migration. Mount migration requires a stable application path; do not run it directly from a DMG or temporary location.

Keep the drive connected while using migrated apps and data. Allow removable-volume access when macOS requests it. Quit related apps before unmounting or ejecting the drive, and back up important data beforehand. See the quick start guide.

⚠️ Permissions

Use the readiness checks to configure Full Disk Access for protected app data. macOS may request app management, Finder automation, or administrator authorization depending on the operation.

1. Open System Settings → Privacy & Security.
2. Select Full Disk Access.
3. Click +, add the copy of AppPorts you are currently running, and enable it.
4. Quit and reopen AppPorts.

(The in-app guide opens Settings directly. Readiness checks show the running app's version and path; individual directories may still have other access restrictions even after the check passes.)

🧑‍💻 Development

git clone https://github.com/wzh4869/AppPorts.git

Open the project with Xcode and build.

🤝 Contributing

We welcome Issues and Pull Requests! If you find translation errors or have suggestions for new features, please let us know.

AppPorts Heroes 💗

💗 Sponsor

AppPorts is completely free, open source and free of ads. It is maintained by a single developer in his spare time and generates no revenue. If it has freed up tens of gigabytes on your disk, you are welcome to scan the QR code and buy the author a coffee — any amount is welcome, and even the smallest one means a lot.

• When sponsoring, please leave your nickname and, optionally, a link (GitHub profile, blog, social account, etc.) in the message. They will be shown on the About AppPorts page in the app and on the sponsor page of the documentation site.
• There is no minimum amount — give whatever feels right. Sponsors are ordered by amount (highest first) and, for equal amounts, by sponsorship date (earliest first); the amount is only shown on the sponsor page.

Thanks to the following sponsors (this list is kept in sync with sponsors.json in the repository root):

• 师杀 · space.bilibili.com/396481888
• zed
• VC
• 符华

Advanced Storage Management

• LazyMount-Mac: Easily expand Mac storage space — Automatically mount SMB shares and cloud storage at startup, no manual operation required.

  The perfect companion for AppPorts. LazyMount connects the storage, AppPorts handles the applications.

  • 🎮 Game Libraries — Store Steam/Epic games on a NAS, play them like local installs
  • 💾 Time Machine Backups — Back up to a remote server automatically
  • 🎬 Media Libraries — Access your movie/music collection stored on a home server
  • 📁 Project Archives — Keep large files on cheaper storage, access them on-demand
  • ☁️ Cloud Storage — Mount Google Drive, Dropbox, or any rclone-supported service as a local folder

Star History

📄 License

This project is open-source under the Apache License 2.0.

See the Privacy Policy.