Installing Marlin
To install Marlin on your printer you’ll first need to Download Marlin, then edit your Configuration files, and finally use an IDE to Compile the Marlin project into a binary form and Upload it to your board. The build process can seem daunting at first, but after you do it a few times you’ll be a pro.
Marlin only needs to be re-flashed when fixed settings are changed in the configuration files. Many settings are only defaults and can be changed (and saved to EEPROM) with G-codes. See each option’s description in the configuration files to find out which G-codes apply.
Download
Links for current and previous versions can be found on the Download Marlin page. If you need an older or specific version go to the Marlin Releases page on GitHub.
Configure
To configure Marlin you can start with one of our example configurations, then you’ll use VSCode, Arduino IDE, or your favorite text editor to make modifications according to your preferences. Marlin is configured with two files: Configuration.h and Configuration_adv.h. See Configuring Marlin for full details.
Build and Install
Marlin installation can vary depending on which version of Marlin you want to install and which board you’re installing onto. Once your Marlin build environment is set up installing updates can be a one-click operation.
| Marlin Version | Platform(s) | Instructions |
|---|---|---|
| 1.1.9 or 2.x | 8-bit AVR, 32-bit ARM | Install Marlin with PlatformIO |
| 2.1.x | 8-bit AVR, 32-bit ARM | Install Marlin with PlatformIO in a DevContainer |
| 1.1.x or 2.x | 8-bit AVR | Install Marlin with Arduino IDE |
- Marlin 1.0 does not support PlatformIO. For older versions of Marlin use Arduino IDE.
- Marlin 1.1 fully supports PlatformIO, and Marlin 1.1.9 even provides an automated build process.
- Marlin 2.0 and up include 32-bit ARM support. PlatformIO is not required for AVR boards.
Looking for Example Configurations for your machine?
- Marlin 1.1.x : Included in the ‘
example_configurations’ folder. - Marlin 2.x.x : Hosted separately. Links on the Downloads page.
Troubleshooting
Troubleshooting a complex piece of software with a minimal interface can sometimes be challenging, even for the most experienced 3D printing enthusiast. Please use our Troubleshooting Guide for tips on some common problems.