Skip to main content

Installation

This guide covers how to install the Morph compiler and toolchain on your system.

System Requirements​

ComponentRequirement
OSWindows 10+, Linux (x64), macOS (ARM64)
Disk Space~200 MB for compiler + toolchain
RAM4 GB minimum, 8 GB recommended
ToolchainBundled MinGW/GCC (Windows) or system GCC/Clang

Installation Steps​

Windows​

  1. Download the latest Morph release archive
  2. Extract to your preferred location (e.g., C:\Morph)
  3. Add the bin/ directory to your system PATH
  4. Verify the installation:
morph help

The bundled toolchain includes MinGW GCC — no separate compiler installation is required.

Linux​

  1. Download the Linux release archive
  2. Extract and add to PATH:
tar -xzf Morph-linux-x64.tar.gz
export PATH="$HOME/Morph/bin:$PATH"
morph help

macOS (ARM64)​

  1. Download the macOS release
  2. Extract and add to PATH:
tar -xzf Morph-macos-arm64.tar.gz
export PATH="$HOME/Morph/bin:$PATH"
morph help

Verifying the Installation​

Run the following command to confirm everything works:

morph help

You should see the Morph ASCII banner and a list of available commands.

Environment Variables​

VariablePurpose
MORPH_TOOLCHAIN_BINOverride the bundled GCC/binutils directory
MORPH_TRACE_ERRORSEnable detailed source-context error traces (1 or true)
MORPH_COLOREnable/disable colored diagnostics (0 or 1)
NO_COLORDisable colors (standard convention)
MORPH_RUNTIME_CACHE_DIROverride runtime object cache location (see generated Branding.generated.h / config/branding.toml)

Building from source​

If you are working in the compiler repository rather than installing a release bundle, use the morphc driver instead of a prebuilt morph binary: see Getting started with development.

Next Steps​