Get started

Installation

Every download lives on niah.si/download, which detects your platform and offers the right installer first.

System requirements

macOS	macOS 12 (Monterey) or later. Apple silicon and Intel builds are published separately.
Windows	Windows 10 or later, on x64 or ARM64.
Linux	A glibc-based 64-bit distribution, on x64 or ARM64.

Niah is built on Electron, so its baseline is the same as other Electron 42 applications. Signing in and using cloud models also needs outbound HTTPS to niah.si and api.niah.si.

macOS

Pick the build that matches your chip. On Apple silicon (M-series) use ARM64; on Intel Macs use x64. If you are unsure, open About This Mac and check the chip name.

`.dmg`	Recommended. Open it and drag Niah into Applications.
`.pkg`	Guided installer, useful for managed fleets and MDM deployment.
`.zip`	Portable app bundle — unzip and run it from anywhere.

First launch: macOS verifies the app with Gatekeeper the first time you open it, which can take a few seconds before the window appears. Launch it from Applications rather than from the mounted disk image so updates can apply in place.

Windows

`.exe`	Recommended. Standard setup wizard that installs for all users on the machine.
`.msi`	For Group Policy or other automated enterprise deployment.
`.zip`	Portable — extract and run `Niah.exe`, no installer required.

Both x64 and ARM64 builds are published for each format.

Linux

`.deb`	Debian and Ubuntu. Install with `sudo apt install ./<file>.deb`.
`.rpm`	Fedora and RHEL. Install with `sudo dnf install ./<file>.rpm`.
`.AppImage`	Portable. `chmod +x` the file and run it directly.
`.tar.gz`	Plain archive — extract and run the `niah` binary inside.

.deb and .tar.gz ship for x64 and ARM64; .rpm and .AppImage are x64.

Direct download URLs

For scripted installs and image builds, artifacts are served from a stable, predictable path. Every file follows the same shape:

text

https://api.niah.si/code/releases/<version>/artifacts/Niah-<version>-<platform>.<ext>

So for version 0.2026.1:

bash

# macOS, Apple silicon
https://api.niah.si/code/releases/0.2026.1/artifacts/Niah-0.2026.1-darwin-arm64.dmg

# Windows, x64
https://api.niah.si/code/releases/0.2026.1/artifacts/Niah-0.2026.1-win32-x64.exe

# Linux, x64
https://api.niah.si/code/releases/0.2026.1/artifacts/Niah-0.2026.1-linux-x64.deb

The <platform>.<ext> suffix is one of:

macOS	`darwin-arm64`, `darwin-x64` × `.dmg`, `.pkg`, `.zip`
Windows	`win32-x64`, `win32-arm64` × `.exe`, `.msi`, `.zip`
Linux	`linux-x64`, `linux-arm64` × `.deb`, `.tar.gz`; `linux-x64` also as `.rpm`, `.AppImage`

Pinning a version: these URLs are immutable once published, so they are safe to reference from a Dockerfile or provisioning script. To resolve the newest version programmatically, read https://api.niah.si/code/releases/latest.json.

Launch from the terminal

Niah can install a niah shell command so you can open folders from a terminal. Open the Command Palette (⌘⇧P / Ctrl+Shift+P) and run Shell Command: Install 'niah' command in PATH. Then:

bash

niah .              # open the current folder
niah path/to/repo   # open a specific project

Once Niah opens, sign in and make your first change — that takes about five minutes and is covered in the Quickstart.

NextQuickstart → ReferenceUpdates →