Installation

Download Octarine

Head over to the releases page and pick the version that matches your operating system.

macOS

1. Download the .dmg file for your Mac:
   • macOS (ARM) for Apple Silicon Macs (M1/M2/M3/M4)
   • macOS (Intel) for older Intel-based Macs
2. Open the downloaded .dmg file
3. Drag the Octarine icon to your Applications folder
4. Eject the disk image
5. Launch Octarine from your Applications folder

After the first manual installation, Octarine will periodically check for updates and install them automatically.

Windows

1. Download the .msi installer
2. Run the installer file
3. If you see a blue security screen warning, click Run Anyway (the Windows version isn't notarized yet because the process is tricky and expensive, but it's completely safe)
4. Follow the on-screen instructions and choose your installation location
5. Launch Octarine from the Start menu

After the first manual installation, Octarine will periodically check for updates.

Linux

Octarine ships in multiple formats for Linux: AppImage, RPM, TAR, Debian, and Arch Linux.

AppImage (Recommended)

The AppImage version supports automatic updates. Here's how to install it:

1. Download the AppImage file
2. Open a terminal in the directory where you downloaded the file
3. Make it executable:

chmod +x Octarine_<version>_amd64.AppImage

4. Run the app:

./Octarine_<version>_amd64.AppImage

Other Formats

For DEB, RPM, or Arch (.pkg.tar.zst) packages, follow the standard installation process for your distribution. These formats do not support Octarine's in-app installer, so update them through your package manager or download and install a newer package manually.

Nix (Community Maintained)

A community-maintained Nix package for Octarine is available through the Nix User Repository (NUR). The package is named octarine-bin.

Troubleshooting

Wayland users with RPM: If you're running into issues on Wayland, try forcing the X11 backend and disabling hardware compositing with these environment variables:

GDK_BACKEND=x11 LIBGL_ALWAYS_SOFTWARE=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 octarine

Quick Answers