Skip to main content
Coral ships as a desktop app on macOS, Linux, and Windows.

​
Install Coral

Download Coral from the releases page. The newest release is at the top. Open its Assets list and download the file for your platform.
The macOS app runs on Apple silicon only.
  1. Download coral-app-mac-arm64.dmg from the newest release.
  2. Open the DMG and drag Coral into your Applications folder.
  3. Launch Coral and add your first providers from the app.
Coral keeps running in the background after you close the window, so your agents can still reach it.

​
Upgrade

The desktop app updates itself. It downloads updates in the background. When an update is ready, Coral lets you know. Select Restart to Update to install it right away, or it installs the next time you quit. To check yourself, select Check for Updates… in the Coral menu on macOS, or in the Help menu on Linux and Windows. On Linux, Coral replaces the AppImage file in place, so keep it somewhere you can write to.

​
From Coral 0.x

Coral 1.0 is a new app with its own data folder. It doesn’t update the 0.x app, and it doesn’t read or change that app’s data. Install Coral 1.0 as described above, then add your providers again. Uninstall the 0.x app when you no longer need it. If you run the coral runtime yourself instead of the desktop app, see Upgrade from Coral 0.x.

​
Uninstall

Select Coral > Quit Completely, then move Coral to the trash. Quit Coral only closes the window.
Uninstalling keeps your data, so your providers and accounts are still there if you reinstall.