Installation

Download

Grab the latest release for your platform from the download page.

Install

macOS

Open the DMG → drag Arkloop to Applications.

Windows

Run the .exe installer and follow the prompts.

[!WARNING] SmartScreen may show an "unrecognized app" warning. Click "More info" → "Run anyway".

Linux

AppImage — make it executable and run:

chmod +x Arkloop.AppImage
./Arkloop.AppImage

deb / rpm — install with your package manager:

sudo dpkg -i arkloop.deb      # Debian/Ubuntu
sudo rpm -i arkloop.rpm       # Fedora/RHEL

First Launch

When you start Arkloop for the first time, several things happen automatically:

• Sidecar services download and start in the background
• Local database is created
• Built-in agents are seeded and ready to use

No manual configuration is needed at this stage — the setup wizard handles the rest.

Command Line

Desktop can install the ark command-line tool on first launch or from Settings -> Updates. The command starts the same local runtime without opening the Desktop window:

ark web

For a headless Linux host, use one command:

sh -c 'set -e; arch="$(uname -m)"; case "$arch" in x86_64|amd64) arch=amd64 ;; aarch64|arm64) arch=arm64 ;; *) echo "unsupported architecture: $arch" >&2; exit 1 ;; esac; name="ark-linux-${arch}"; rm -rf "$name"; curl -fsSL "https://github.com/qqqqqf-q/Arkloop/releases/latest/download/${name}.tar.gz" | tar -xz; cd "$name"; exec ./ark web --host 0.0.0.0 --no-open'

Window Management

Arkloop adds a system tray icon. Minimizing the window sends it to the tray instead of the taskbar. The tray menu offers Show, Settings, and Quit.

You can configure close behavior in Settings: keep running in the background (default), or quit entirely when the window is closed.