Installation

Download

Download the latest version of Iruka from iruka.sh/downloads. The download is a standard .dmg disk image.

Install

  1. Open the .dmg file
  2. Drag Iruka.app to your Applications folder
  3. Eject the disk image
  4. Open Iruka from Applications (or Spotlight with ⌘ Space)

On first launch macOS may show a Gatekeeper dialog — click Open to proceed. Iruka is notarised by Apple so this prompt only appears once.

Install via Homebrew

Iruka is also available as a Homebrew cask:

brew install --cask dorienh/iruka/iruka

This downloads and installs the same signed, notarised build as the .dmg. Future versions can be updated the same way Iruka itself checks for updates (see Updating), or by running brew upgrade --cask dorienh/iruka/iruka.

Optional: "Open in Iruka" in Finder's right-click menu

Iruka ships a Finder extension that adds Open in Iruka to Finder's right-click menu. Apple makes every Finder extension opt-in, so switch it on once in System Settings → General → Login Items & Extensions → Finder Extensions, then tick Iruka.

Iruka has to be in /Applications for macOS to offer it — see Finder Integration for the toolbar button and the other ways to send a folder to Iruka.

Required Permissions

Iruka requests a small set of permissions the first time each feature is used:

PermissionWhy it's needed
Full Disk Access (optional)Browse files outside your home folder in the file manager
NetworkSSH connections and file transfers
Notifications (optional)Alerts when a long-running command finishes

Iruka will not request any permission until the relevant feature is first used.

Updating

Iruka checks for updates automatically at launch and notifies you in the app when a new version is available. Click Install Update and Iruka relaunches into the new version — no manual download needed.

To check for an update manually: Iruka → Check for Updates…

Uninstalling

  1. Quit Iruka
  2. Move Iruka.app from Applications to Trash
  3. (Optional) Remove preferences: ~/Library/Preferences/com.dorienherremans.iruka.plist