Setting up SimplyPrint on Flashforge Adventurer 5M

Welcome to the Flashforge Adventurer 5M (Pro) setup guide for SimplyPrint!

In this guide, we'll walk you through the steps to connect your Flashforge Adventurer 5M or 5M Pro to SimplyPrint using the Klipper Mod, an unofficial modification that runs Moonraker, Klipper, Mainsail & Fluidd on your printer.

This guide is based on the excellent work by xblax. For the latest updates and detailed information, visit the official Klipper Mod GitHub repository.

Alternative option: ZMOD firmware — also supports the AD5X model. If you have an AD5X or prefer ZMOD, see our AD5X guide and the ZMOD project.

Links: ZMOD GitHub • AD5X setup guide • AD5X SimplyPrint discussion

What is the Klipper Mod?

The Klipper Mod is designed to unlock the full power of open source software on your Flashforge AD5M (Pro) while remaining fully removable and not breaking any functions of the stock software.

Features include:

• Klipper 0.13 with improved configuration
• Moonraker, Mainsail, and Fluidd web interfaces
• Camera streaming support
• Network access via Ethernet and WiFi
• SSH root access (Login: root, Password: klipper)
• "Dual boot" capability with stock Flashforge software

Note: This mod is currently in beta stage. While stability is promising, it still needs long-term testing.

Supported Printers

This guide supports:

• Flashforge Adventurer 5M
• Flashforge Adventurer 5M Pro
• Unsupported:
  • The AD5X printer is, to our knowledge as of October 2025, not supported by the "flashforge_ad5m_klipper_mod" community-firmware
    • An alternative community-made firmware, the ZMOD project on GitHub, supports both 5M, 5M Pro and the AD5X

Important: The mod installer requires that your printer was updated to at least version 2.4.5 of the stock Flashforge firmware. Please check the releases page for versions that are known to work.

Before You Begin

What you'll need:

• A USB flash drive (formatted as FAT32)
• Your printer updated to at least firmware version 2.4.5

Choose your variant: The Klipper Mod comes in three variants:

• Default (headless): No on-screen GUI control application
• KlipperScreen: Beta variant with full-fledged KlipperScreen installation
• GuppyScreen: Alpha variant with lightweight UI

For most users, we recommend starting with the default variant.

Installation Steps

1. Download the Klipper Mod:

• Visit the Klipper Mod releases page.
• Download the latest Adventurer5M-KlipperMod*.tgz file for your printer.
• For 5M Pro owners: Rename the file to Adventurer5MPro-*.tgz (the archives are identical, but the 5M Pro requires this naming).

2. Prepare the USB Drive:

• Format your USB drive as FAT32.
• Not sure how to format? Right-click the drive on Windows and select "Format". On macOS, use Disk Utility and select "Erase" with MS-DOS (FAT) as the format.
• Copy the downloaded .tgz file directly to the root of the USB drive.

3. Install on the Printer:

• Turn off your printer if it's currently on.
• Plug the USB drive into the printer before starting it.
• Turn on the printer.
• The printer will automatically detect and install the Klipper Mod.
• During installation, the MCU firmware will be updated to match the Klipper version.
• Success will be indicated on the display when finished.

4. Check the Installation Log (if needed):

• After installation, a log file klipper_mod_install.log will be written to the USB drive.
• If installation fails, check this file for error details.

Initial Network Setup

After installation, the mod is pre-configured for DHCP (automatic IP assignment).

To find your printer's IP address:

• Connect the printer via Ethernet cable to your network.
• Check your home router's web interface to find the IP address assigned to the printer.

Optional - WiFi setup:

• For WiFi configuration, visit the Klipper Mod WiFi documentation.
• You can also install custom WiFi configuration files during installation. See the Install documentation for details.

Access Your Printer's Web Interface

Once installation is complete and your printer is on the network, you can access:

• Mainsail: http://[printer-ip]:4000
• Fluidd: http://[printer-ip]:4001
• Moonraker: Port 7125
• Camera stream: http://[printer-ip]:8080 (if configured)

Replace [printer-ip] with your printer's actual IP address.

Dual Boot with Stock Firmware

You can still boot the stock Flashforge software while the mod is installed:

• USB drive method: Place a file named klipper_mod_skip on a USB drive and plug it in before printer start.
• SSH method: Log in via SSH and run reboot-stock-system.
• Klipper macro: Execute the REBOOT_STOCK_SYSTEM macro.

When using dual boot, the MCU firmware automatically switches between stock and Klipper versions.

Important Notes

• Updating the mod: Download the new version and follow the same installation steps. Most local changes will be lost during updates, so back up important files first.
  • Uninstalling: Follow the uninstall guide to remove the mod and restore stock functionality.
  • Help & support: Visit the GitHub Discussions or open an Issue if you encounter problems.

Now, proceed to the next step where we'll connect your printer to SimplyPrint!