colonizer

quickstart · the latest release

one command. then open the mothership.

install the latest release, run it, and launch your first colony from the cockpit.

the full guide, with building from source: /docs/install

three steps

install, sign in, launch.

  1. 1

    check the prerequisites

    linux x86_64 with kvm and claude code, or apple silicon. plus git and gh.

  2. 2

    install a release

    Open this page on your computer to install Colonizer.

    https://colonizer.dev/quickstart

    Email me the link

    curl -fsSL https://colonizer.dev/install.sh | sh

    Installs on an Apple silicon Mac or a Linux x86_64 computer (not on a phone or tablet).

    run it again, or colonizer update, to update. with rust: cargo install colonizer-harness --locked, then colonizer setup.

  3. 3

    open the mothership

    run colonizer, follow its sign-in link, connect github and claude, and launch a colony.

verified against sha256sums and build provenance. linux: smoke-tested in ci only. details →

per platform

what your machine needs.

macOS

needs an apple silicon mac, plus git and gh.

curl -fsSL https://colonizer.dev/install.sh | sh

Installs on an Apple silicon Mac (not on a phone or tablet).

the same installer; it fetches the colonizer-darwin-arm64 release. there is no .dmg yet.

Linux

needs x86_64 with /dev/kvm, plus git and gh.

curl -fsSL https://colonizer.dev/install.sh | sh

Installs on a Linux x86_64 computer (not on a phone or tablet).

the same installer; it fetches the colonizer-linux-x86_64 release.

windows runs through WSL2 (harness#1314); native Windows is later (harness#1091). install guide →