Guides / Install
Install kosa8
Two ways in. Pick the Mac app if you want an icon to double-click; pick the one-line installer if you live in a terminal. They install the same thing.
The Mac app
Download kosa8_0.1.3_macos_app.zip from
the releases page, unzip it,
and drag kosa8.app to your Applications folder.
The app carries the command-line tool and the background service inside it, so this is the only thing you need — there is nothing to install first. It is signed and notarized by Apple, so it opens without a warning.
One line
$ curl -fsSL https://kosa8.com/install.sh | sh
The installer works out whether you have an Apple or Intel chip, checks the download against the
published fingerprints before anything runs, and puts kosa8 on your PATH.
Homebrew
$ brew tap AzmxAI/kosa8 $ brew install kosa8
Windows
PS> irm https://kosa8.com/install.ps1 | iex
Linux
The same one-line installer works, and there are .deb, .rpm and
.apk packages on the releases page.
Only Apple Silicon Macs can run the containers, because the isolation is built on Apple's
Virtualization framework. On Windows and Linux you get the command-line tool, which you point at a
Mac with KOSA8_HOST and KOSA8_TOKEN. Every command then works normally.
Check it worked
Start the background service
Nothing runs until the daemon is up. The Mac app starts it for you.
$ kosa8 daemon start
Run something
$ kosa8 run alpine echo hi hi
If anything looks wrong
kosa8 doctor checks the parts that commonly go wrong — the daemon, the guest
images, the virtualization entitlement — and tells you which one is missing.
$ kosa8 doctor
Your first sandbox — make a sealed machine and run something inside it.