When installing Potato on a Mac, the step that most often causes trouble is not dragging the app into place but rather system permissions, first-launch prompts, and subsequent update checks. The following is organized in the actual order of operations so you can troubleshoot directly if you run into problems.
Preparation Before Installation and Installer Verification
First, get the macOS-compatible installer from the download page. After downloading, it is a good idea to check in Finder whether the file size matches what is stated on the page, and confirm that the file type is .dmg or .pkg. If the browser reports that the file is incomplete or the size is noticeably too small, delete it and download again rather than repeatedly double-clicking a corrupted package.
After opening the .dmg, drag Potato into the Applications folder instead of running it directly from the mounted disk image. If you run it directly from the image, the mounted volume is unmounted after you quit, and the app path becomes invalid, which shows up as the icon doing nothing the next time you click it. After installation is complete, eject the disk image from the Finder sidebar.
First Launch and Granting Permissions
The first time you open Potato, macOS may show a prompt saying the developer cannot be verified or that the app is from an unidentified developer. At this point, do not keep clicking the icon; instead, go to System Settings → Privacy & Security, find the corresponding prompt near the bottom of the page, and choose Open Anyway. This only needs to be done once; afterward, a normal double-click will work.
On first launch, the app will also request several types of permissions. Granting them as needed is the safer approach:
- Notifications: Used to receive new message alerts. If you do not need them, you can decline for now and enable them later in System Settings.
- Microphone and camera: Only needed for voice or video calls. For text-only chats, you can leave these unauthorized for now.
- Files and folders: When sending files, the system will show a selection window. Granting per use is sufficient; you do not need to give access to the entire disk.
- Screen recording: Only needed for screen sharing. It is not required for ordinary chats.
If you accidentally click Don't Allow, you can find the corresponding entry in System Settings → Privacy & Security and check it again. After making changes, you usually need to restart Potato for them to take effect. For more information about permissions, see Privacy and Permission Information.
Update Checks and Common Troubleshooting
Potato's update check is generally done in the app's settings or About page. It is a good idea to manually click Check for Updates from time to time, especially if you notice message sending failures or abnormal interface display. Quit the app before updating to avoid files being in use during installation.
Here is how to handle a few specific scenarios:
- Double-clicking the icon does nothing: Confirm that the app is in the Applications folder and check whether it has been blocked by Privacy & Security.
- The app crashes immediately after launch: Restart the Mac and try again. If it still does not work, delete the app and reinstall; login information is generally unaffected.
- A prompt says the version is too old to connect: Complete the update check first, then log in again.
- Permissions stop working after an update: Return to the Privacy & Security page and reauthorize the microphone or notifications.
If the problem centers on login, verification codes, or account status rather than installation itself, see the FAQ, where account troubleshooting steps are described in more detail. For scenarios involving automated messages, see the separate Bot Feature Guide.
A Few Habits to Make Installation Smoother
Keeping your macOS version from being too outdated can reduce trouble caused by signature verification and permission prompts. It is recommended to obtain the installer only from this site's Potato download page, avoiding third-party packaged versions from unknown sources. After installation is complete, pin Potato to the Dock so it launches faster next time and it is easier to confirm that it is indeed running from the Applications directory.
Overall, installation difficulties on macOS are concentrated in permissions and first launch. By following the order above, most prompts can be resolved on your own. For more version news, keep an eye on subsequent updates in the News section.
Continue reading: downloads and installation, accounts and verification codes, groups, channels, and bots, and privacy and security.
