EZPi Getting Started Documentation

You are here:
< Back

Getting Started with the EZPi

NOTE: When removing the SD card be careful as they are delicate devices. Warranty does not cover if you crack the SD card when removing from the EZPi case.

When you connect the EZPi to your machine it should automatically connect and display the IP address of your Pi on the printer LCD. If it does not you can try typing http://octopi in your browser to access it. If that fails check your router to see what DHCP address the EZPi grabbed from the router then access it through your web browser (example:

Please note use a modern browser like Chrome, FireFox, Safari, or Edge to access the EZPi. Internet Explorer 11 and lower all have issues with the UI working correctly.

If the EZPi auto connects to your printer you will see the IP on your printer LCD. If not see below on connecting to the printer.

Connecting the EZPI

Power – Use the included AC power adapter to connect to the EZPi Power Input. If you have the EZPi Pro connect the MicroUSB adapter cable to the end of the EZPi AC adapter before connecting to the USB C Power Port on the EZPi Pro.

Printer (USB) – Use the USB cable for your printer (not supplied with kit) to connect to any of the USB ports on the EZPi kit.

Webcam (USB, optional) – Connect the USB webcam to any of the USB ports on the EZPi kit.

Network (wired) – If you are using a wired network connection (recommended) connect the network cable (optional) to the Wired Network Port on the EZPi Kit.

Network (wireless) – If you are using wireless to connect the EZPi to the network and had us configure it the EZPi should automatically connect to your router. All the Raspberry Pi boards have small onboard antennas so make sure you are not too far from your router to pickup the signal. The antennas have about the same range as a cellphone wifi antenna for comparison. If you are going to use wireless but did not have us configure it please see below for a video on setting up the wifi on the kit and be careful removing the MicroSD card as you can damage the card if you are too rough with it.

Finding your EZPi IP address Manually

In the event that your printer uses a different baud rate than the factory default on the EZPI (115200) you will not get a connection with the IP address on your printer LCD screen.

With your EZPi powered up, connected to your printer, and network you can run this tool to scan your network: Advanced IP Scanner

Once the scan finishes you will see all the devices on your network. Look for one that has “octopi” listed anywhere in the “Name” column. That will be your EZPi device.

That IP address will need to be entered into your web browser.

For example if the IP address is then you will enter into your web browser. Your IP address will be different than the one shown above as this is scanned on our network here.

Default Login for EZPi:

  • Default Username: ezpi
    • Default Password: EzP1.Th3D
  • Default SSH Username: pi
    • Default Password: EzP1.ssh

Per user request the latest EZPi V2 image does NOT contain a secondary login for recovery purposes. If you lose your password you will need to re-image the SD card and lost passwords are not something we can recover.

Connecting a USB Camera

If you have or purchased a USB camera to connect to the EZPi you need to connect it before powering up the EZPi kit for it to be recognized by Octoprint. We recommend the Logitech HD Cameras that we carry and the EZPi works with *most* Logitech cameras on the market. We only guarantee compatibility with the Logitech Models we carry (the C270 and C310).

Powering the EZPi

Included with every kit is a wall AC adapter that supplies 5V 3A to the Pi itself. If you get the Pi Direct Wire Power adapter as part of the kit you will need to supply a MicroUSB cable. When selecting a USB cable use the shortest one possible and not a cheap one. Cheap MicroUSB cables cannot handle the current that the Pi needs to run and if your cable is too low quality the red LED on the Pi (look inside the case near the MicroUSB plug) is off then the USB cable cannot handle the 2.5A minimum that the Pi needs to run.

Recommended Cables:

Reloading the EZPi Image

In the event you want to start over or you break the EZPi with a plugin or change and it will not boot again you can restore the factory image by removing the MicroSD card from the EZPi and “burning” it to the SD card again. The flashing tool is for a Windows PC. We have not tested imaging from Mac or Linux.

You are welcome to use this on your own Pi but this is provided AS-IS with NO warranty or support for non-EZPi customers. Requires a 32GB MicroSD or larger. Tested on the following boards: 3B, 3B+, 4B 1GB, 4B 2GB.

Download Latest Image (EZPi V2.0)

Flashing Tools

SD Card Removal Tools (Printable)

The EZPi is ONLY meant to be used through your web browser. There is no frontend installed for use over a monitor with HDMI or the AV port.

If you have a webcam connected it is displayed under the “Printer Control” tab that has the gamepad controller icon. See below for a UI legend.


EZPi Home Page

Note: EZPi V2 Software no longer contains the “Print History” section as the plugin no longer works correctly on the latest OctoPrint images.

Connection Setup

Please follow the step below to set your printer baud rate if the EZPi cannot auto-detect the printer connection. Most Creality machines use 115200. Tevo uses 250000. It will either be 115200 or 250000, try 115200 first.

Most printers use 115200 or 250000 for their baud rate. Try 115200 first as most machines use this.

Printer Setup

Wifi Setup/Change Directions

NOTE: When removing the SD card be careful as they are delicate devices. Warranty does not cover if you crack the SD card when removing from the EZPi case.

STL Files for EZPi Case and Direct Power Adapter

How do I use the Direct Wire power adapter?

Stuck in “cancelling” mode?

This is an OctoPrint bug. Here is the workaround: https://discourse.octoprint.org/t/octoprint-wont-cancel-after-1-3-7-update/1176/31?u=foosel

We will be implementing a fix in the next image and updating to the next OctoPrint version when it prompts you should resolve this as well. As of 1.3.9 it is not fixed in OctoPrint.