Install Vela
Vela for macOS
macOS 26 or later · Apple silicon & Intel · Signed and notarized
Requirements
- macOS 26 Tahoe or later.
- Apple silicon or Intel. Vela is a universal app, so the same download runs natively on both.
Install from the disk image
- Download Vela.dmg. It's always the latest release.
- Open the downloaded file. A window with the Vela icon and your Applications folder appears.
- Drag Vela onto Applications.
- Eject the disk image, then open Vela from Applications, Launchpad or Spotlight.
Every release is signed with a Developer ID and notarized by Apple, so macOS opens it without a security warning. The first time, macOS may still ask you to confirm that you want to open an app downloaded from the internet. Click Open.
Next
Continue with First launch to add your first network.
Updating
Vela doesn't update itself yet (automatic updates are on the roadmap). To update:
- Quit Vela (⌘Q).
- Download the latest Vela.dmg and drag Vela into Applications again. Choose Replace when asked.
Your networks, settings, themes and history are kept. They live outside the app, so replacing it doesn't touch them. The changelog lists what changed in each release.
Uninstalling
Quit Vela and drag it from Applications to the Trash.
To remove your data too, delete Vela's container folder:
text~/Library/Containers/io.github.r3volution11.VelaIt holds your settings, networks, themes and message history. In Finder, choose Go → Go to Folder… (⇧⌘G) and paste the path.
Saved passwords, channel keys and client certificates are in your login keychain. Open Keychain Access and search for
io.github.r3volution11.Velato remove them.
Building from source
Vela is open source. If you'd rather build it yourself, you need Xcode 27 or later:
git clone https://github.com/r3volution11/Vela-IRC.git
cd Vela-IRC
scripts/run.sh # builds and launches build/Vela.appSee the README for details.