Skip to content

Installation Guide

Joshua Wise edited this page Sep 19, 2024 · 51 revisions

X1Plus Install Guide

Welcome to X1Plus! We're glad to have you aboard. This document will guide you through installing X1Plus custom firmware on your Bambu Lab X1 Carbon printer. This guide describes how to install X1Plus for the first time; to upgrade an existing X1Plus installation, follow the steps in the X1Plus User Manual.

Step by step guide video

Michael Laws @ Teaching Tech has generously provided a step by step guide video you can use along with this documentation to install X1Plus on your printer. You can watch it here: https://www.youtube.com/watch?v=39UJQnr2Iko

Getting started

To start, make sure you have read and understand the risks associated with installing X1Plus.
You should make sure you understand that X1Plus comes with NO WARRANTY, EXPRESS OR IMPLIED, and is provided entirely as is, with any and all faults. You are entirely responsible for determening whether its installation and use is right for you.

Requirements:

  • A Bambu Lab X1 Carbon printer connected to the Internet. Bambu Lab X1E is not currently supported by X1Plus.
  • A MicroSD card, 16GB or larger, FAT32 formatted. High Endurance or Industrial cards are recommended.
    • Do note that many operating systems cannot format cards larger than 32GB as FAT32 with their default formatting tools. You can also format your SD card by booting OEM firmware instead of X1Plus and using the format option in the General tab.
  • The latest X1Plus Installer software for your computer (Windows, Mac, and Linux are supported).

Unlock your printer and get your access codes

Make sure that your printer has the latest version of Bambu Lab's Official Rootable Firmware. To install it:

  • Go to the Third Party Firmware Plan page on the Bambu Lab web site. Log in, accept the terms, and attach your printer to the Third Party Firmware Plan.
  • Open the Bambu Handy app on your phone, and choose "downgrade". Select the latest Official Rootable Firmware to be installed on your printer (it will have a version number between 01.06.06.55 and 01.06.99.99). Wait for it to install on your printer. (If the Official Rootable Firmware does not appear in the downgrade list, you may first have to downgrade to version 01.07.04.00 before it appears.)
  • On your printer, enable root SSH access. Go to image -> General, and write down the Access Code; this is your LAN access code. Then, tap on Third Party Firmware Plan, and follow the directions to unlock your printer's firmware. The General tab should look as shown below.

  • Write down your root SSH password. If it is difficult to distinguish between "1"s, "I"s, "l"s, "O"s, and "0"s, consider resetting the password until you get one that is easier to read! The root SSH password screen should look as shown below.

You can now proceed to starting the X1Plus installation process.

Start the X1Plus Installer on your computer

  • Before you start the installer, make sure that you have closed all slicer software, including Bambu Studio and Orca Slicer. If you do not, the installer may fail to start, or may fail to detect your printer.
  • Unpack the installer bundle as appropriate for your computer, and launch the installer binary. (On macOS, the installer has a code signature, and should launch without trouble. On Windows, it does not, and you may need to override your system's security settings.)
  • Select your printer, enter the LAN Access Code that you wrote down from above, and then enter the root password that you wrote down from above. If everything is OK, there will be no red text.
  • If you understand the risks of installing X1Plus, check the "I know installing custom firmware is risky" checkbox. The screen should look as shown on the right.
  • Click the "Install X1Plus" button. The firmware installation process will begin; it will take a few minutes to copy files to your printer, so be patient.
  • When the installer has copied files to your printer, it will instruct you to continue the process from your printer's touchscreen.

Run the on-printer installer

  • The X1Plus installation software should start on your printer, and the following screen should display, with information about the version of X1Plus firmware that is being installed. Make sure that it displays the same version here as the one you downloaded, and then press the green install button at the bottom.

  • A confirmation screen will appear. Read it carefully. If you choose "Yes! Install X1Plus!", the installation onto your printer and SD card will begin.

  • A prompt will appear to download the base firmware from Bambu Lab servers. (Although installing X1Plus offline after rooting your printer is technically possible, it is not an officially supported flow right now.) Tap "yes" to begin the download.

  • The firmware will download, and then the rest of the installation process will continue. The following steps take quite a few minutes, so don't worry -- just be patient! 🙂 You can also monitor the installation progress from the computer-based installer.

  • Installation should complete! Tap on the "Reboot" button or power cycle your printer to boot into the X1Plus firmware.

Booting into X1Plus for the first time

After your printer reboots, you should see the following boot screen. At this point you can boot the X1Plus firmware from the SD card (or wait for the timer to count down). This screen also provides access to the advanced boot menu if you need it in the future.

If your installation is successful, the printer should load X1Plus. (It may take a minute or two to start up.) Enjoy your enhanced printer firmware!

Troubleshooting

  • Slicer or Bambu Handy app interfering. If you launch the installer with a slicer running, you will get an error (usually EADDRINUSE), and the installer may not be able to detect your printer. Close the installer, close any slicers that you have running, and then restart the installer.

  • Windows Firewall (or other firewall software). If the installer is not able to discover your device, and you've closed all slicer software, try temporarily disabling any firewall settings on you computer and reopen the installer. Several users running Windows firewall were unable to select their device's IP in the X1Plus installer until they disabled Windows firewall.

  • Incorrect firmware version. The X1Plus installer only supports installation on Official Rootable Firmware. Please enroll your printer and install a compatible firmware version.

  • Issues with discovery or LAN code denied. If you cannot proceed in the installer after entering your LAN code, and you have already closed any slicers that are open, log out of your Bambu account on the touchscreen, log back in, and reboot the printer. Additionally, The installer uses MQTT to initiate certain steps of X1Plus' installation, so please also ensure that any applications you use that send MQTT commands to the device are disabled during installation.

  • X1Plus is already installed. If you are looking to update X1Plus, please follow the upgrade guide in the X1Plus User Manual.

  • ECONNRESET. This is typically caused by a noisy/unreliable WiFi environment. If you can, try moving your printer closer to your router/AP (but not closer than 1m).
    You can also try and use "WiFi compatibility mode" by clicking the Install button on the installer 10 times.

Welcome to the X1Plus wiki!

Perhaps you would like to read:

Or perhaps you would just like to download the latest release?

Clone this wiki locally