Browse this article for solutions to common Mac installation and launch issues.

<aside> đź“Ś NOTE: We do have a Web App that does not require download. The only product that does not work in the web app today is the Digital Twin Creation Tool. You can access the web app here.

</aside>

Installation Fails

Solution:

  1. Move the Agora install package from “Downloads” folder to “Desktop”. Then run the installer again.

The Agora Launcher instantly closes when I open it.

Solution:

  1. Make sure you've used the mac installer ".pkg" file to install Agora
  2. If you've moved the Agora Launcher files from the location they were installed, move them back

Other Potential Solutions:

  1. If you are using a Mac with an M1 chip, make sure Rosetta is working.
  2. The launcher is supposed to auto-close when updating is finished, and launch the app automatically at that time.

The Agora Launcher says “Updating Process Failed”.

Solutions:

  1. Double check that your internet is connected and working.

  2. Try re-installing the Agora Launcher via your provided download link.

(This guarantees that your launcher is the most updated version. Make sure to close the Agora app before re-launching the launcher).

  1. In rare cases, you may need to move the "Agora Launcher.app" file to your Documents folder or Desktop. You can find it under MacintoshHD->Users->Shared. Note: MacintoshHD may instead be named whatever you named your harddrive. Simply drag and drop Agora Launcher.app to Documents folder or Desktop and launch it from there.

  2. If for some reason you don't have a Shared folder, you may need to enable File Sharing on MacOS (first half of tutorial linked here). Enabling file sharing should auto generate the Shared folder at MacintoshHD->Users but if it doesn't you can manually make the folder via the second half of this tutorial: