- OctoPi and OctoPrint Mini Guide
A complete guide for setting up OctoPi and Octoprint for the Prusa Mini. While this guide is biased towards OctoPi -- which packages OctoPrint, mjpg-streamer, and more for the raspberry pi -- if you want to use OctoPrint on another platform feel free to skip to the OctoPrint setup instructions after installation.
This guide will be more useful if you have all the equipment required. Here is a list:
- Prusa Mini 3D Printer
- Raspberry Pi (Raspberry Pi A, B, A+, B+, 2B, 3A+, 3B, 3B+, 4B 1/2/4GB, don't bother with zero models) w/ a power cord. You should really only consider the Pi3B+ or 4B Models.
- SD card (the bigger then better, especially if you have a camera)
- A USB or raspberry pi compatible camera (optional but highly recommended)
- A USB A to USB micro cord
These are instructions specific to setting up OctoPi
- Download the Etcher applicatoin to flas the SD card: https://www.balena.io/etcher/
- Go to https://octoprint.org/download/ and download the latest OctoPrint image.
- Insert your SD card into your computer.
- Open Etcher
- Click on "Flash from file" and select your newly downloaded OctoPrint image.
- Click on "Select target" and select the sd card drive.
- Click on "Flash!" and wait until flash drive is finished.
If you plan on using ethernet, skip this step.
- Download the Sublime Text Editor: https://www.sublimetext.com/3
- On your computer navigate to the newly flashed SD card. There will be a file called
octopi-wpa-supplicant.txt. Open this in sublime text. - Change the WPA 2 section with your SSID and Wi-Fi password (at least you should be using this vs WEP or no security). This is shown below.
- Save
octopi-wpa-supplicant.txtand close sublime text.
Before
## WPA/WPA2 secured
#network={
# ssid="put SSID here"
# psk="put password here"
#}
After This assumes the wi-fi network you are connecting to is called "YourWifi" and the password to connect to it is called "yourwifipassword"
## WPA/WPA2 secured
#network={
# ssid="YourWifi"
# psk="yourwifipassowrd"
#}
Go here for more detailed instructions: https://community.octoprint.org/t/wifi-setup-and-troubleshooting/184
In order to setup OctoPrint it's time to power it up.
- Remove the mini sd card from your computer and insert it into your raspberry pi.
- Connect power to your raspberry pi.
This will setup some system level settings (Linux):
- Log into your Pi via SSH (it is located at octopi.local if your computer supports bonjour or the IP address assigned by your router),
- default username is “pi”, default password is “raspberry”.
- Run
sudo raspi-config. Once that is open: - Change the password via “Change User Password”
- Change the configured timezone via “Localization Options” > “Timezone”.
Now it's time to setup OctoPrint. This includes setting up better security, your mini printer, etc using the OctoPrint web interface.
Finally we are ready to setup your Mini printer with OctoPrint
| Setting Name | Prusa Mini Value |
|---|---|
| Form Factor | Rectangular |
| Origin | Lower Left |
| Heated Bed | true |
| Heated Chamber | false |
| Width (X) | 180mm |
| Depth (Y) | 180mm |
| Height (Z) | 180mm |
| Custom Bounding Box | true |
| X Coordinates | 0 / 180 |
| Y Coordinates | -4 / 180 |
| Z Coordinates | 0 / 180 |
| Setting Name | Prusa Mini Value |
|---|---|
| X | 10800 mm/min |
| Y | 10800 mm/min |
| Z | 720 mm/min |
| E | 4800 mm/min |
| Setting Name | Prusa Mini Value |
|---|---|
| Nozzle Diameter | 0.4 mm |
| Number of Extruders | 1 |
- On OctoPrint, go to Settings (wrench icon) > Features > API and copy the API Key
- In PrusaSlicer, go to the “Printer Settings” tab and switch the “Advanced” or “Expert” configuration levels.
- Under “General” modify the “Print Host upload” with the following settings:
- Hostname, IP or URL: octopi.local (or whatever you modified it to be)
- API Key/Password: The API key you copied above
- Save as a new profile and use this whenever you want to be able to directly upload to the printer.
- Under “General” modify the “Print Host upload” with the following settings:
Plugins allow developers to expand the base functionality of OctoPrint. There are at least a couple of plugins that should be considered essential for mini owners. Each plugin can consume addition resources which can result in degraded printing performance if OctoPrint is slow to send the current g-code instructions over the serial connection as a result of your raspberry pi's CPU being too high.
Here are the plugins you should defenitley install:
| Plugin Name | Description |
|---|---|
| PrusaSlicer Thumbnails | This plugin will extract the embedded thumbnails from PrusaSlicer gcode files where the printer's profile ini file has the thumbnail option configured. This is default behavior for the Prusa Mini printer profile. |
| OctoPrint-Prusa-Mini-ETA | This plugin will provide ETA estimates, which are broken with the base installation |
This attempts to answer common issues that mini owners have experienced.
This seems to be a common issue and is probably related to the Mini's slightly recessed usb port. The theory is that a lot of cables do not work well because cannot make contact with the recessed port. Some users have reported trying four USB cables before they found one that was able to connect properly.
Restart your OctoPrint instance in safe mode. This will start it without all the plugins. Then try the same print job, etc, and see if the problems persist. Almost all problems are caused by plugins.