mstrap (short for "machine bootstrap") is a tool for provisioning and managing a development environment. It is a convention-over-configuration tool, which aims to leverage existing ecosystem tools to provide a one-command provisioning experience for a new machine.

The approach is inspired by the chirpstrap tool built at Iora Health, but is built and maintained in my personal capacity and is not associated with Iora Health.


mstrap is wholly centered around proving a no-runtime-dependency (other than normal system libraries) approach and will always remain a tool designed around being possible to run immediately after taking a new machine out of its box, and finishing the OS setup.

Installation & Usage

Please refer to the documentation site for documentation


  1. Install dependencies
1. [Install Crystal](
2. `sudo apt install libevent-dev libpcre3-dev libreadline-dev libssl-dev patchelf`
  1. git clone
  2. make
  3. bin/mstrap will be created

Building multi-arch

To build multi-arch, you'll need to configure Docker to enable BuildKit-based multi-arch support, and register the proper binfmt handlers to run ARM binaries through QEMU.

On Ubuntu 20.04, this can be done via the following:

$ sudo apt install --no-install-recommends qemu-user-static binfmt-support
$ docker run --privileged --rm tonistiigi/binfmt --install arm64,arm
$ sudo systemctl restart docker.service


  1. Fork it (<>)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request