---
title: Installation
description: Platform-specific setup instructions for Octarine
---

## Download Octarine

Head over to the [releases page](https://octarine.app/releases) 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.

> On Windows, you might see the standard "repair/upgrade" installation prompt during future 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:

```bash
chmod +x Octarine_<version>_amd64.AppImage
```

4. Run the app:

```bash
./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)](https://github.com/nix-community/nur). The package is named [`octarine-bin`](https://nur.nix-community.org/repos/dzoidberg/).

### 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:

```bash
GDK_BACKEND=x11 LIBGL_ALWAYS_SOFTWARE=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 octarine
```

#### Quick Answers

### Where can I download Octarine?

Download Octarine from the [releases page](https://octarine.app/releases), then choose the installer for your operating system.

### Does Octarine support macOS, Windows, and Linux?

Yes. Octarine provides builds for macOS, Windows, and Linux.