EZPi Getting Started Documentation

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: http://172.16.21.122).

Please note use a modern browser like Chrome, Brave, 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.

Please make sure to keep the EZPi kit out of enclosures, direct sunlight, or spaces that have high ambient temps (35C+). Overheating will cause issues and shorten the lifespan of the EZPi kit.


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 pick up 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 172.16.21.22 then you will enter http://172.16.21.22 into your web browser. Your IP address will be different than the one shown above as this is scanned on our network here.


Default Logins

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

Per user request the latest EZPi Pro 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 EZCAM HD Cameras that we carry and the EZPi works with *most* Logitech cameras on the market. We only guarantee compatibility with the EZCAM HD Cameras and Select Logitech Models – C270/C310.


Powering the EZPi

Included with every kit is a wall AC adapter that supplies 5V 3A to the Pi itself, this is the recommended way to power our kits.

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.

If you have the EZPi Pro it will throw an undervolt error if you use it with the older Pi Direct Wire that we sell. The Pi Direct Wire is only for the 3B+ and lower models as they draw lower current than the newer 4B boards. The Pi Direct Wire on our site is not listed as compatible with the EZPi Pro for this reason.

Recommended Cables:


Mounting the EZPi Pro/Plus (Optional)

Some people have requested to be able to mount the EZPi Pro/Plus to their 3D printer so we’ve made an STL file that lets you do this.

If you have the new EZPi Pro/Plus we have made a mount that lets you set the EZPi Pro/Plus on to standard 2020 extrusion with 2x M4/M5 Bolts and TNuts.


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.

EZPI Pro Image (64-bit) – Released 6/30/2020 – Works with 3B, 3B+, and 4B Boards

Download Latest EZPi Pro Image (V1)

Based on OctoPi 0.18.0 5/27/20 Nightly

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 16GB MicroSD or larger. The EZPi Pro Image is intended for use with the Pi 4B boards but does work on the older 3B and 3B+ boards as well.

If your kit shipped with the 64-bit image will show “EZPi Pro” on the main web interface screen.

Flashing Tools

SD Card Removal Tools (Printable)


EZPi Web Interface

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/Pro Software no longer contains the “Print History” section as the plugin no longer works correctly on the latest OctoPrint images.


USB 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.


Setting a Static IP, Hostname, and Camera Options


STL Files for EZPi Case and Direct Power Adapter


Direct Wire power adapter – For 3B & 3B+ Pis

Table of Contents