Install katamaran
Install katamaran on an Apple silicon Mac and connect the Docker command-line tools to it.
Requirements
Section titled “Requirements”- An Apple silicon Mac (M1 or later)
- macOS 15 or later
- The Docker command-line tools (
docker,docker-buildx, anddocker-compose)
Install the Docker command-line tools with Homebrew if you do not have them yet:
brew install docker docker-buildx docker-composeIf you plan to run linux/amd64 images at native translation speed, install Apple Rosetta:
softwareupdate --install-rosettaInstall with Homebrew
Section titled “Install with Homebrew”brew install --cask nklmilojevic/katamaran/katamaranOpen Katamaran from /Applications after Homebrew finishes.
Install from the disk image
Section titled “Install from the disk image”- Download and open the latest signed Katamaran.dmg (or browse all versions on GitHub releases). To build the disk image yourself, follow Build from source.
- Drag
Katamaran.appinto/Applications. - Open Katamaran from
/Applications.
On first launch, Katamaran runs katamaran setup --default automatically. Setup installs:
- A LaunchAgent in
~/Library/LaunchAgents/that runs thekatamaran daemonprocess at login - A Docker context named
katamaranpointing tounix://$HOME/.katamaran/run/docker.sock, set as the default Docker context whenever Katamaran launches - A symlink at
~/.local/bin/katpointing to thekatamaranbinary inside the app bundle
Add ~/.local/bin to your shell PATH so you can run kat from any terminal.
Run setup manually
Section titled “Run setup manually”To run setup from the command line, execute:
katamaran setupTo also make katamaran your default Docker context, pass --default:
katamaran setup --defaultIf you run a second isolated development instance with KATAMARAN_HOME, pass --suffix so its LaunchAgent, Docker context, and symlink do not collide with your main installation:
KATAMARAN_HOME=~/.katamaran-dev katamaran setup --suffix devVerify the installation
Section titled “Verify the installation”Check that the VM is running and Docker responds:
kat statusdocker --context katamaran infoUninstall
Section titled “Uninstall”To remove the LaunchAgent, the Docker context, and the ~/.local/bin/kat symlink, run:
kat uninstallkat uninstall stops the daemon and leaves ~/.katamaran intact so your containers, images, volumes, and Linux machines stay on disk. Delete ~/.katamaran manually if you want to remove all stored data.