---
title: "System & troubleshooting"
description: "Requirements, install and updates, the macOS permissions o8 asks for, and fixes for the common gotchas."
canonical_url: https://o8.run/docs/system
md_url: https://o8.run/docs/system.md
last_updated: 2026-06-25
version: "0.1.431"
stability: stable
---

# System & troubleshooting

> Requirements, install and updates, the macOS permissions o8 asks for, and fixes for the common gotchas.

## Requirements

o8 is a native macOS app — a Next.js front end inside a Tauri shell, not a web app or Electron.

- **macOS 14 or later.**
- **Intel or Apple Silicon** — o8 ships one signed Intel build. On Apple Silicon it currently runs under Rosetta; a native arm64 build is on the way.

## Install & updates

Download the `.dmg` from [o8.run/download](/download), drag o8 to **Applications**, and on first launch **right-click the app → Open** (the standard one-time macOS step). After that, o8 **auto-updates** — it checks for new releases and applies them in the background, and every update is **signed and verified** before it's trusted, so you stay current without doing anything.

## Permissions

If you use voice (Symon / dictation), o8 asks for a few macOS permissions — one-time grants in **System Settings → Privacy & Security**:

| Permission | Why |
|---|---|
| **Accessibility** | To capture the global push-to-talk hotkey and paste dictated text into whatever app you're in. |
| **Input Monitoring** | A separate, stricter grant so the hotkey actually receives key events. Both this and Accessibility must be on. |
| **Microphone** | To hear you, for dictation and Symon. |

You only need these if you use voice; the rest of o8 works without them.

## Troubleshooting

- **`o8: command not found`** — the `o8` CLI is a symlink o8 installs on launch. If it's missing, **relaunch the o8 app once** (it re-creates the link), then open a fresh terminal.
- **The app won't open on first launch** — **right-click → Open** instead of double-clicking, to clear the one-time macOS prompt.
- **The voice hotkey does nothing** — check that **both** Accessibility *and* Input Monitoring are enabled (they're separate toggles), then relaunch o8 so it picks up the grant.
- **Dictation is silent** — Microphone was likely denied; re-enable it in System Settings → Privacy & Security → Microphone.