thinkyhead bob-the-kuhn

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

Start by downloading the Marlin source code. There are a few codebases to choose from.

Download 2.0.x Current release
Download 1.1.x Previous release
Download 1.0.x Older release
Download bugfix-1.1.x “Nightly” build. Proceed with Caution!
Download bugfix-2.0.x “Nightly” build. Proceed with Caution!
  • 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.

Configure

To configure Marlin you can use the Arduino IDE or your favorite text editor to edit the Configuration.h and Configuration_adv.h files. See Configuring Marlin for full details.

Build and Install

Marlin installation procedure 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.x or 2.x 8-bit AVR Install Marlin with Arduino IDE
1.1.9 or 2.x 8-bit AVR, 32-bit ARM Install Marlin with PlatformIO
2.0 LPC1768 (Re-Arm) Install Marlin on Re-ARM

Looking for Example Configurations for your machine?

  • Marlin 1.1.x : Included in the ‘example_configurations’ folder.
  • Marlin 2.0.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.