> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arakun.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Arakun

> Install Arakun on macOS, Linux or Windows with one line in a terminal, pick a version, keep it up to date, and see what Linux needs.

## Run the installer

```sh macOS and Linux theme={"dark"}
curl -fsSL https://arakun.dev/install | sh
```

```powershell Windows theme={"dark"}
irm https://arakun.dev/install.ps1 | iex
```

On macOS and Linux, run it in a terminal. It works on macOS with Apple silicon and on Linux x86\_64 and arm64. It picks the build for your machine. On Windows, run it in PowerShell.

## What the script does

It downloads the latest release, checks it against `SHA256SUMS` and installs it for your user. When `minisign` is installed (or OpenSSL 3 on Linux and macOS), it also checks that `SHA256SUMS` is signed with Arakun's release key. Without one, it checks only the checksum and says so. On macOS, `brew install minisign` adds the check.

| Platform | Installs to | To uninstall |
| - | - | - |
| macOS | `~/Applications/Arakun.app`, linked as `~/.local/bin/arakun` | `rm -rf ~/Applications/Arakun.app ~/.local/bin/arakun` |
| Linux | `~/.local/bin/arakun`, and the browser's runtime in `~/.local/share/arakun/cef` | `rm -rf ~/.local/bin/arakun ~/.local/share/arakun/cef` |
| Windows | `%LOCALAPPDATA%\Programs\Arakun`, added to your user `PATH`, with a Start menu shortcut | Delete that folder and the shortcut, and remove it from `PATH` |

## A given version

```sh theme={"dark"}
curl -fsSL https://arakun.dev/install | sh -s -- --version v0.17.0
```

Or set `ARAKUN_VERSION=v0.17.0`. On Windows, set `$env:ARAKUN_VERSION = "v0.17.0"` before you run the installer.

Linux arm64 builds start at v0.5.0. On an arm64 machine, an older version does not install.

> [!WARNING]
>
> There is no build for Intel Macs yet. [Build from source](https://github.com/ArakunHQ/arakun#build-from-source) there.

## Nightly builds

Every night that `main` changed, a nightly build comes out. Nightlies are for testers. Nobody tests them by hand: one can crash, lose a session or change how your data is stored, and a release may not read what a nightly wrote.

```sh theme={"dark"}
curl -fsSL https://arakun.dev/install | sh -s -- --nightly
```

On Windows, set `$env:ARAKUN_VERSION = "nightly"` first. A nightly installed this way keeps following nightlies.

## Updates

A release keeps itself up to date. Every 6 hours it asks GitHub for the latest release, downloads it and checks it against the signed `SHA256SUMS`. The update is installed when you quit Arakun, so the next start runs it.

Settings › General › Updates shows the version and has **Check now**, and **Restart now** on Linux and macOS. Turn off **Update automatically** there to stop the checks. **Nightly builds** there switches to nightlies.

From a terminal:

```sh theme={"dark"}
arakun update            # download the latest release; installed when Arakun quits
arakun update --check    # only say whether there is a newer one
arakun restart           # install it now (Linux and macOS)
```

> [!NOTE]
>
> Arakun updates itself only where it runs from, so that folder must be yours. A copy that a package manager installed, or a build from source, does not update itself.

## Only the server

On a Linux machine with no display (x86\_64 or arm64), such as a VPS, install `arakun-server` alone. It needs glibc 2.35 or newer and none of the desktop libraries. See [Server](https://docs.arakun.dev/server.md). On other architectures, [build it from source](https://github.com/ArakunHQ/arakun#build-from-source).

```sh theme={"dark"}
curl -fsSL https://arakun.dev/install-server | sh
```

It installs `~/.local/bin/arakun-server`. It also installs what the server runs agents with, if it is missing: git and gh with the system's package manager, Node.js 22 in `~/.local/share/arakun/node`, and Claude Code (run `claude` once to sign in). `--no-tools` leaves all four to you, and `--nightly` installs the newest nightly.

The server does not update itself. Run the line again for a new release, then restart the service if it runs as one.

## What Linux needs

glibc 2.35 or newer (Ubuntu 22.04+, Debian 12+, Fedora 36+), a Vulkan driver and the usual desktop libraries: libxkbcommon, Wayland or X11, fontconfig and freetype.

Without a GPU, as in a VM, Mesa's software Vulkan driver works, only slower: `mesa-vulkan-drivers` on Debian, Ubuntu and Fedora, `vulkan-swrast` on Arch. Without a graphics driver or a desktop, `arakun` says what is missing and exits.

## Agents come separately

Arakun does not bundle the agents. Install the ones you want to use. The first launch checks which ones are there. Each agent's page in these docs says what it needs.

> [card] [Claude Code](https://docs.arakun.dev/claude-code.md)
>
> Runs through the ACP adapter.

> [card] [Codex](https://docs.arakun.dev/codex.md)
>
> OpenAI's Codex, signed in with your ChatGPT plan or an API key.

> [card] [Droid](https://docs.arakun.dev/droid.md)
>
> Runs Factory's droid CLI.

> [card] [OpenCode](https://docs.arakun.dev/opencode.md)
>
> Runs the opencode CLI.

> [card] [Devin](https://docs.arakun.dev/devin.md)
>
> Runs Cognition's devin CLI.

> [card] [Cursor](https://docs.arakun.dev/cursor.md)
>
> Runs the Cursor CLI, cursor-agent.

> [card] [Antigravity](https://docs.arakun.dev/antigravity.md)
>
> Runs Google's agy CLI.

> [card] [Workers AI](https://docs.arakun.dev/workers-ai.md)
>
> A tool loop Arakun runs against the Workers AI API.

> [!NOTE]
>
> **Optional tools**
>
> `git` for Changes, worktrees and branches, `gh` for CI and the GitHub tab, `bwrap` for headless and sandboxed agents on Linux, `secret-tool` for stored logins on Linux, `tailscale` for the phone over Tailscale, `cf` for the Cloudflare tab.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.