Docs

Installation

Install Isolade on macOS or Linux, and what each platform needs.

Install

One command covers both platforms. It detects your OS and architecture and runs the right steps:

curl -fsSL https://isolade.com/install.sh | sh

Pin a specific release with ISOLADE_VERSION=v1.2.3.

Requirements

  • macOS: Apple Silicon only. The VMs use Apple’s Hypervisor framework, which ships with macOS.
  • Linux: Debian and Ubuntu, x86_64 or arm64. You need KVM, and your user has to be in the kvm group.

Check that KVM is available and you can reach it:

ls -l /dev/kvm
groups | grep kvm

If kvm isn’t listed, add yourself and log back in:

sudo usermod -aG kvm "$USER"

First launch

On first run, Isolade creates its config directory at ~/.config/isolade with an example config.env and a secrets.env (already in .gitignore). Nothing else is required to start the app.

See the configuration layout for what lives where, then the quickstart to build your first workspace.