Installing on macOS

Requirements

• macOS 10.15 (Catalina) or later
• Minecraft Java Edition

Installation Steps

1. Download CoralProxy

   Download the appropriate version for your Mac:

   • Apple Silicon (M1/M2/M3/M4): Use the ARM version
   • Intel Mac: Use the standard version

   Not sure which version?

   If your Mac was purchased in 2020 or later, you most likely have Apple Silicon. You can check by clicking the Apple menu → About This Mac.

2. Open the DMG File

   • Locate the downloaded .dmg file in your Downloads folder
   • Double-click to mount the disk image

3. Install CoralProxy

   • Drag the CoralProxy app icon to the Applications folder
   • Wait for the copy to complete

4. Launch CoralProxy

   • Open your Applications folder
   • Double-click CoralProxy to launch it
   • If macOS shows a security warning, right-click the app and select “Open”, then confirm

5. Grant Permissions

   • macOS may ask for permissions to access certain features
   • Grant the necessary permissions for CoralProxy to function properly

Next Steps

After installing CoralProxy, explore the Features section to learn about all available features.

Troubleshooting

App Won’t Open Due to Security Restrictions

Since CoralProxy is not signed with an Apple Developer certificate, macOS may prevent it from opening. If you see an error message saying “CoralProxy is damaged and can’t be opened. You should move it to the Trash” or any other security warning, run this command in Terminal:

sudo xattr -rd com.apple.quarantine /Applications/CoralProxy.app

This removes the quarantine attribute that macOS applies to downloaded applications.

Other Issues

If you encounter any other issues during installation, join our Discord server for support.