# Installation

OpenOnyx is a desktop app for macOS, Windows, and Linux. Install it, then choose a folder. No account is required for local writing.


## Why it exists

The desktop app gives Markdown files a fast editor, graph, canvas, and thinking layer without moving them into a hosted database.

## When to use it

Install OpenOnyx when you want a local workspace for an existing folder or a new personal vault.

## Workflow

Download → install → launch → [choose a folder](<Open a Vault.md>) → create a note.

## Install

| Platform | Package |
| --- | --- |
| macOS | `.dmg` or `.zip` |
| Windows | `.exe` installer or portable executable |
| Linux | `.AppImage`, `.deb`, or Arch package |

Get the current build from [GitHub Releases](https://github.com/OpenOnyx/OpenOnyx/releases).

> **OpenOnyx tip**
> Keep the application and your vault separate. Updating OpenOnyx should never replace your notes.

> **OpenOnyx common mistake**
> An installer changes the application, not your vault. Open a vault only after you know which folder you intend to use.

## Continue learning

- [Open a Vault](<Open a Vault.md>)
- [Writing Notes](<Writing Notes.md>)
- [Privacy](<Privacy.md>)