Support & FAQ

It depends on the drive. DiskPort uses symbolic links (symlinks) to redirect Xcode to the new location. From Xcode's perspective, the files are still at the original path — it doesn't know they've moved.

Performance depends on the speed of your external drive:

• Thunderbolt/USB4 SSD: Virtually no difference. Modern external SSDs over Thunderbolt deliver read/write speeds close to internal storage.
• USB 3.1/3.2 SSD: Minimal impact. You might notice a slight difference on very large projects, but it's generally negligible.
• USB HDD (spinning disk): Not recommended for DerivedData. Build times will be noticeably slower. Use HDDs only for archives or old device support files that aren't accessed during builds.

Our recommendation: relocate archives, old device support files, and simulator caches to any external drive. Only relocate DerivedData if you have a fast SSD.

DiskPort needs Full Disk Access to scan certain protected directories inside ~/Library/Developer/. Here's how to grant it:

1. Open System Settings (or System Preferences on older macOS)
2. Navigate to Privacy & Security → Full Disk Access
3. Click the + button (you may need to unlock with your password or Touch ID)
4. Navigate to Applications and select DiskPort
5. Toggle the switch next to DiskPort to ON
6. DiskPort may ask you to restart the app — click Restart

DiskPort will prompt you to do this on first launch if the permission is not already granted. You can also grant it proactively before opening the app.

Why is this needed? macOS restricts access to certain Library folders by default. Without Full Disk Access, DiskPort can scan most locations but may miss some Xcode caches, giving you an incomplete picture of your storage usage.

Yes. Every relocation in DiskPort is reversible with one click.

When you use Smart Relocate, DiskPort:

1. Copies the files to the destination drive
2. Verifies the copy is complete (checksum verification)
3. Replaces the original with a symlink pointing to the new location
4. Records the operation in a local manifest

To roll back, open the Relocations panel in DiskPort and click Rollback next to the relocation you want to undo. DiskPort will:

1. Copy the files back from the external drive to the original location
2. Remove the symlink
3. Verify the restoration is complete

Important: Rollback requires the external drive to be connected and the files to be intact. If the external drive has failed or the files have been manually deleted, rollback will not be possible. Always maintain proper backups of critical data.

Yes. DiskPort scans the standard Xcode storage directories (~/Library/Developer/) which are shared across all installed Xcode versions. Whether you have Xcode 15, 16, or a beta installed side by side, DiskPort sees and manages all of their storage.

The Project Awareness feature (Pro) can also distinguish which DerivedData folders belong to which Xcode version based on build metadata, so you can clean up data from old Xcode versions without affecting your current setup.

DiskPort requires macOS 14 Sonoma or later. It runs natively on both Apple Silicon and Intel Macs.

We appreciate bug reports. You can report issues through any of these channels:

• Email: support@jimmylv.cn — include your macOS version, Xcode version, and a description of the issue
• GitHub Issues: github.com/nicekid1/diskport-xcode/issues — for detailed technical bug reports

When reporting a bug, it helps to include:

• What you expected to happen
• What actually happened
• Steps to reproduce the issue
• Your macOS version (e.g., macOS 15.2)
• Whether you're using the Free or Pro version