Platform Support

mstrap aims to support a variety of developer workstation platforms. As there are many possible platforms that could be supported, support is defined based on a set of tiers that indicate the level of support for that platform.

Note: This approach is based on the Crystal platform support matrix.

In general, the two most recent versions of a supported platform are aimed to be supported.

Tier 1

Tier 1 platforms are fully supported, tested platforms. Specifically they will each satisfy the following requirements:

  • Official binary releases are provided for the platform.
  • Automated testing is set up to run tests for the platform.
  • Documentation for how to use and how to build the platform is available.
Platform Description Notes
macOS 10.15 amd64 macOS Catalina Signed and notorized
macOS 11.x amd64 macOS Big Sur Signed and notorized
Ubuntu 18.04 LTS x86_64 amd64 Ubuntu Bionic
Ubuntu 20.04 LTS x86_64 amd64 Ubuntu Focal

Tier 2

Tier 2 platforms can be thought of as “expected to work”. Automated tests are not run so it’s not guaranteed to produce a working build, but platforms often work to quite a good degree and patches are always welcome! These platforms may be tested manually from time-to-time.

Official binary releases are intended to be usable with these platforms as well.

Platform Description Notes
macOS 10.14 amd64 macOS Mojave
Fedora 31 x86_64 amd64 Fedora 31 Requires reboot after Docker install to enable cgroups v1 compatibility
Fedora 32 x86_64 amd64 Fedora 32 Requires reboot after Docker install to enable cgroups v1 compatibility

Tier 3

Tier 3 platforms are those which mstrap has some sort of support for, but which are not built or tested automatically.

Official releases are not guaranteed to work.

Platform Description Notes
Ubuntu 18.04 LTS arm64 aarch64 Ubuntu Bionic
Ubuntu 20.04 LTS arm64 aarch64 Ubuntu Focal
Debian Stable x86_64 amd64 Debian “buster”
Debian Unstable x86_64 amd64 Debian “sid”
CentOS 7.7 x86_64 amd64 CentOS 7 Release 7
CentOS 8 x86_64 amd64 CentOS 8
RHEL 7 x86_64 amd64 RedHat Enterprise 7 Licensing restrictions prevent automatic Docker install
RHEL 8 x86_64 amd64 RedHat Enterprise 8 Licensing restrictions prevent automatic Docker install