Skip to content

Building Marlin

Jump to bottom
cefiar edited this page Aug 11, 2025 · 4 revisions

Steps to build Marlin from source.

  1. Clone a copy of the Marlin repo.
  2. Install Docker-Desktop 2.3 or later.
    1. If on Linux, install the Docker Compose plugin (1.21 or later). Do not use the Ubuntu snap package.
    2. If on Windows 10 Home, install WSL2 Back-end.
  3. Install VSCode.
  4. Within VSCode, install the C/C++ helper extension and the PlatformIO extension. You will need to reload/restart VSCode.
  5. Within VSCode, open the folder of the Marlin repo you cloned in.
  6. Make any edits to the following files in the Marlin repo:
    • Marlin/Configuration.h
    • Marlin/Configuration_adv.h
    • platformio.ini
  7. Hit the build button in VSCode to compile.

Resulting firmware will be built into the file .pio/build/[board_name]/firmware.bin, where [board_name] is the motherboard name defined in Marlin/Configuration.h and in platformio.ini (should be the same and match the hardware you are building).

Clone this wiki locally