Installation

Download Octarine

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

macOS

Standard Installation

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

Standard Installation

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 RPM, DEB, TAR, or Arch packages, follow the standard installation process for your distribution. Note that these formats may not support automatic updates—you'll need to manually download new versions from the releases page.

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