# Setting Up Your Flashforge Adventurer 5M Pro ## About Your Printer Your **Flashforge Adventurer 5M Pro** has good potential, but there's an extra step before we can connect it. **The situation:** The manufacturer has shipped this printer with restrictive software that doesn't allow third-party integrations like SimplyPrint. However, the 3D printing community has created alternative firmware that removes these restrictions. **What this means:** Before SimplyPrint can be installed, you'll need to install community-made or unofficial firmware that "opens up" the printer. This is sometimes called "rooting" the printer. **Why is this needed?** This isn't a SimplyPrint limitation - it's a restriction imposed by the manufacturer. They chose not to be open and easy to integrate with. We do our best to make SimplyPrint as easy to install as humanly possible, but in this case, the manufacturer's choices require an extra step. **Is it safe?** Community firmware is generally well-tested and often adds useful features beyond just enabling SimplyPrint. However, it may void your manufacturer warranty. The choice is yours. **After rooting:** Once the community firmware is installed, SimplyPrint can be installed directly on the printer just like any other Klipper-based printer. **Need help with rooting?** Check our guides or community forums for your specific printer model. --- ## Setup Options ### Recommended: Adventurer 5M Series We have a specific setup guide for your Flashforge Adventurer 5M Pro. Follow these steps for the best experience. **Note:** This setup requires flashing custom firmware ### Alternative Options - **[Standard setup (OctoPrint-powered)](/setup-guide/methods/octoprint-powered.md)**: If you prefer using a Raspberry Pi with OctoPrint instead of the printer's built-in web interface ### Need Help Deciding? - Your printer needs custom firmware installed before SimplyPrint can be set up - Follow the rooting/firmware guide first, then come back here - After rooting, your printer will run Klipper and can connect directly --- ## Adventurer 5M Series Setup Guide ### Step 1: 5M Klipper firmware ## Before You Start: Custom Firmware **This printer requires custom firmware to work with SimplyPrint.** We know that sounds technical — and it is one of the more involved setups — but we've worked hard to make it as straightforward as possible. **Why is custom firmware needed?** Some printer manufacturers don't provide an easy way for platforms like SimplyPrint to communicate with their printers. The community has developed alternative firmware that unlocks these capabilities. **Is this safe?** Yes. The firmware we guide you through: - Is developed and tested by active communities - Can typically be removed to restore your original firmware - Preserves your printer's core functionality In most cases, you can always roll back to stock firmware or factory reset your printer if needed. **A note about warranty** Some manufacturers may consider custom firmware a warranty modification. The risk is low — to date, we haven't had a single known case of a SimplyPrint user damaging their printer or being denied warranty repair because of this setup. That said, it's ultimately your choice to proceed. **Estimated time:** 15–30 minutes **We'll guide you through every step.** 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](https://github.com/xblax/flashforge_ad5m_klipper_mod). ----- > **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](https://github.com/ghzserg/zmod) • [AD5X setup guide](/setup-guide/flashforge/ad5x) • [AD5X SimplyPrint discussion](https://github.com/ghzserg/zmod/discussions/196) --- ### 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](https://github.com/ghzserg/zmod), 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](https://github.com/xblax/flashforge_ad5m_klipper_mod/releases) 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](https://github.com/xblax/flashforge_ad5m_klipper_mod/releases). - 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](https://github.com/xblax/flashforge_ad5m_klipper_mod/blob/master/docs/WIFI.md). - You can also install custom WiFi configuration files during installation. See the [Install documentation](https://github.com/xblax/flashforge_ad5m_klipper_mod/blob/master/docs/INSTALL.md) 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. > ℹ️ **New to SSH?:** Check out our setup guide on what it is and how to use it: [SSH: What is it and how to use it](https://help.simplyprint.io/en/article/ssh-what-is-it-and-how-to-use-it-1pb1aq0/) --- ### 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](https://github.com/xblax/flashforge_ad5m_klipper_mod/blob/master/docs/UNINSTALL.md) to remove the mod and restore stock functionality. - **Help & support:** Visit the [GitHub Discussions](https://github.com/xblax/flashforge_ad5m_klipper_mod/discussions) or open an [Issue](https://github.com/xblax/flashforge_ad5m_klipper_mod/issues) if you encounter problems. --- Now, **proceed to the next step** where we'll connect your printer to SimplyPrint! ### Step 2: Enable SimplyPrint Your printer runs Klipper firmware with a web interface (Mainsail or Fluidd). Here's how to connect it to SimplyPrint. #### Find Your Printer's IP Address You need to access your printer's web interface using its IP address (looks like `192.168.1.XXX`). **How to find it:** - **Printer's touchscreen:** Check Settings → Network or WiFi section (location varies by printer) - **Router admin page:** Look for connected devices and find your printer's name - **Network scanner app:** Use an app like "Fing" on your phone to scan your network - **mDNS hostname:** Some printers respond to hostnames like `http://mainsail.local` or `http://fluidd.local` Once you have the IP, type it in any web browser: `http://192.168.1.XXX` You'll see your printer's web interface - either **Mainsail** (dark theme, sidebar on left) or **Fluidd** (lighter theme, gear icon for settings). **Note:** Some printers run their interface on a specific port (e.g., `http://192.168.1.XXX:4408`). If the default doesn't work, check your printer's documentation. --- #### Add `[simplyprint]` to Your Configuration **If you use Mainsail:** 1. Click **Machine** in the left sidebar 2. Under **Config Files**, click `moonraker.conf` - NOTE: If you have a custom config file or one called `moonraker.generated.config`, edit that instead 3. Add this to the bottom of the file (with an empty line above): ``` [simplyprint] ``` 4. Click **Save & Restart** **If you use Fluidd:** 1. Click the **gear icon** (Configuration) 2. Under **Configuration Files**, click `moonraker.conf` - NOTE: If you have a custom config file or one called `moonraker.generated.config`, edit that instead 3. Add this to the bottom of the file (with an empty line above): ``` [simplyprint] ``` 4. Click **Save & Restart** --- #### Link Your Printer to SimplyPrint After saving and restarting, your printer should appear automatically in SimplyPrint! 1. Go to [SimplyPrint.io](https://simplyprint.io) and log in 2. Click **Add Printer** 3. Check **Pending Printers** - your printer will likely appear there automatically 4. Click to add it and you're done! 🎉 **If your printer doesn't appear in Pending Printers:** This can happen if you're not on the same network as your printer (different outgoing IP). In this case, use the setup code: 1. In your printer's web interface, click the **bell icon** (🔔) in the top bar 2. Find the "SimplyPrint Setup Request" notification 3. Copy the setup code and paste it in SimplyPrint under **Add Printer** **Still having trouble?** See our troubleshooting guide: [Printer in setup isn't detected / can't find setup code](https://help.simplyprint.io/en/article/printer-in-setup-isnt-detected-cant-find-setup-code-3jyftm/). This also helps if you can't find Mainsail/Fluidd or the web interface isn't working.