Run the installer
What the script does
It downloads the latest release, checks it againstSHA256SUMS 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.
A given version
ARAKUN_VERSION=v0.16.1. On Windows, set $env:ARAKUN_VERSION = "v0.16.1" before you run the installer.
Linux arm64 builds start at v0.5.0. On an arm64 machine, an older version does not install.
Nightly builds
Every night thatmain 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.
$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 signedSHA256SUMS. 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:
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, installarakun-server alone. It needs glibc 2.35 or newer and none of the desktop libraries. See Server. On other architectures, build it from source.
~/.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.Claude Code
Runs through the ACP adapter.
Codex
OpenAI’s Codex, signed in with your ChatGPT plan or an API key.
Droid
Runs Factory’s droid CLI.
OpenCode
Runs the opencode CLI.
Devin
Runs Cognition’s devin CLI.
Cursor
Runs the Cursor CLI, cursor-agent.
Antigravity
Runs Google’s agy CLI.
Workers AI
A tool loop Arakun runs against the Workers AI API.
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.