Octo 3d printer


OctoPrint.org - Download & Setup OctoPrint

OctoPi (Raspberry Pi) · Octo4a (Android) · Docker install · octoprint_deploy & octoprint_install (Linux) · Manual install (Linux, Windows, Mac)

Guy Sheffer maintains “OctoPi”, a Raspbian (and thus Debian) based SD card image for the Raspberry Pi that already includes OctoPrint plus everything you need to run it:

  • OctoPrint plus its dependencies
  • MJPG-Streamer for live viewing of prints and timelapse video creation, compatible with various USB webcams and the Raspberry Pi camera

Recommended hardware: Raspberry Pi 3B, 3B+, 4B or Zero 2. Expect print artifacts and long loading times with other options, especially when adding a webcam or installing third party plugins. Setups not using recommended hardware are not officially supported.

Please note that the Raspberry Pi Zero and Zero W are not recommended explicitly since severe performance issues were observed, caused by the WiFi interface when bandwidth is utilized (e. g. the webcam is streamed), negatively impacting printing quality. See also here. The Zero 2 however is recommended.

Installing OctoPi

OctoPi is available through the Raspberry Pi Imager, which you can use to download and setup OctoPi. You can install it yourself, or alternatively simply buy one of the available

All-in-one OctoPrint Kits

Installing OctoPi using the Raspberry Pi Imager

🤚 Before you begin

Read and follow these instructions precisely. Most importantly, leave the system username as “pi”, do not change it to anything else or OctoPrint won’t work!

  1. If you haven’t already, download and install Raspberry Pi Imager on your computer

  2. Find the OctoPi image under “Choose OS”, by selecting “Other Specific Purpose OS” > “3D printing” > “OctoPi” and then the “stable” version.

  3. Open advanced options by clicking on the button with the gear, or by using the keyboard shortcut ctrl+shift+x and then:

    • Configure your wifi options: Set your SSID, password and WiFi country:

    • Change the system password in “Set username and password” by entering a new password to use for the system user “pi”. This is not the password you’ll use for logging into OctoPrint but one that you’ll have to use to log into your Pi via SSH should you ever need to. Leave the username as “pi”, do not change it to anything else!

    • Optionally: Change the configured timezone in “Set locale settings”

    • Optionally: Change the hostname in “Set hostname”

  4. Install the image to your SD card, then plug everything in to your Raspberry Pi and boot it up. Do not format the SD card after installing, even if prompted to do so. This will break the installation and you will have to start over!

  5. Access OctoPrint from your browser via http://octopi.local or the hostname you chose (if your computer supports bonjour) or http://<your pi's ip address>. https is available too, with a self-signed certificate (which means your browser will warn you about it being invalid - it isn’t, it’s just not recognized by your browser).

Please also refer to OctoPi’s README, especially the “How to use it” section.

Alternative Initial Setup

If you decide against using the Raspberry Pi Imager, here are some alternative steps to get started:

  1. Flash the image to your SD card through whatever alternative means you’ve chosen.

  2. With the SD card still attached to your computer, set up the Wifi connection using the octopi-wpa-supplicant. txt file on the root of the installed card when using it like a thumb drive. Important: Do not use WordPad (Windows) or TextEdit (MacOS X) for this, those editors are known to mangle the file, making configuration fail. Use something like Notepad++, Atom or VSCode instead or at the very least heed the warnings in the file. If your computer doesn’t see the card right away after flashing, try ejecting and inserting it again. Do not format the SD card after installing, even if prompted to do so. This will break the installation and you will have to start over!

    Please also refer take a look at the full WiFi setup guide in the FAQ that also includes troubleshooting tips.

  3. Plug everything into your Raspberry Pi and boot it up

  4. 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:

    1. Change the password via “Change User Password”
    2. Optionally: Change the configured timezone via “Localization Options” > “Timezone”.
    3. Optionally: Change the hostname via “Network Options” > “Hostname”. Your OctoPi instance will then no longer be reachable under octopi.local but rather the hostname you chose postfixed with .local, so keep that in mind.

    You can navigate in the menus using the arrow keys and Enter. To switch to selecting the buttons at the bottom use Tab.

    You do not need to expand the filesystem, current versions of OctoPi do this automatically.

    You also do not need to manually enable the RaspiCam if you have one, that is already taken care of on the image as well.

  5. Access OctoPrint through http://octopi.local (if your computer supports bonjour) or http://<your pi's ip address>. https is available too, with a self-signed certificate (which means your browser will warn you about it being invalid - it isn’t, it’s just not recognized by your browser).

Please also refer to OctoPi’s README, especially the “How to use it” section.

Image Downloads

Raspberry Pi Imager will download the latest version of OctoPi for you, but if you want to download the images yourself you can do so here.

Stable OctoPi

OctoPi 0.18.0 & OctoPrint 1.8.6 SHA256: 851573629147ec5385b9168a78377b8ed51af0a1d76c2174fe0e4ccb4f637a9d
Raspberry Pi 3B, 3B+, 4B or Zero 2 strongly recommended, Raspberry Pi Zero/Zero W not officially supported!
Image compatible with Raspberry Pi A, B, A+, B+, 2B, 3A+, 3B, 3B+, 4B 1/2/4/8GB, 400, Zero, Zero W and Zero 2.

OctoPi Release Candidate

The current OctoPi Release Candidate 1. 0.0rc2 can be found here:

OctoPi 1.0.0rc2 & OctoPrint 1.8.1 Raspberry Pi 3B, 3B+, 4B or Zero 2 strongly recommended, Raspberry Pi Zero/Zero W not officially supported!
Image compatible with Raspberry Pi A, B, A+, B+, 2B, 3A+, 3B, 3B+, 4B 1/2/4/8GB, 400, Zero, Zero W and Zero 2.

OctoPi Nightlies

You can also get the 32bit nightlies here or the highly experimental 64bit nightlies here.

Further resources

  • For customizing OctoPi, take a look at CustoPiZer.
  • Scripts to build the image yourself can be found in OctoPi’s Github repository.

Filip Grzywok maintains “Octo4a”, an Android app that allows you to use an Android based smart phone as an OctoPrint host. Root is not required!

Check out the Octo4a README for information on how to obtain the app, install and run it.

Video

There’s also a video guide on how to get Octo4a up and running by Thomas Sanladerer.


There’s also an official OctoPrint Docker image, octoprint/octoprint. It is maintained by Brian Vanderbush and team on GitHub.

Please refer to its entry on dockerhub for more details on usage and configuration.


octoprint_deploy is a guided script for creating multiple OctoPrint instances. This enables control of multiple printers on a single piece of hardware. It is compatible with OctoPi and also functions as a general Linux installer for OctoPrint, video streamers, haproxy, etc.

The related octoprint_install serves as a single instance Linux installer.

Both are maintained by Paul Paukstelis.


The generic setup instructions boil down to

  1. Installing Python 3, including pip.
  2. Creating a virtual environment somewhere: python -m venv OctoPrint
  3. Installing OctoPrint into that virtual environment: OctoPrint/bin/pip install OctoPrint
  4. OctoPrint may then be started through . /OctoPrint/bin/octoprint serve or with an absolute path /path/to/OctoPrint/bin/octoprint serve

More specific setup instructions for the most common runtime environments can be found below.

Linux

For installing OctoPrint on Linux, please take a look at the setup instructions for Raspbian on the forum. They should be pretty much identical on other Linux distributions.

Windows

For installing the OctoPrint server on a Windows system, please take a look at the setup instructions for Windows on the forum.

Mac

For installing the OctoPrint server on a Mac, please take a look at the setup instructions for MacOS on the forum.

How to Set Up OctoPrint For Ender 3, CR-10, and Other Creality 3D Printers — Creality Experts

In this guide, we will show you how to set up OctoPrint on your Creality Ender 3, CR-10, or similar printer. We’ll start by explaining what OctoPrint is and why it will improve your 3D printer, and then cover what products you need and how to get OctoPrint up and running with your printer.

Why OctoPrint?

OctoPrint is a software application that allows you to monitor and control your Creality 3D printer over your local network or the Internet. Most people run OctoPrint on a Raspberry Pi, which gives you an easy and low-power way to run the software continuously. 

OctoPrint provides many useful features, but here are some of the top reasons we recommend it:

  • Download GCode to your printer over the network: You no longer need to run back and forth with an SD card or keep the printer next to your computer. You can easily upload new .gcode files to the OctoPrint server over your network.

  • Preheat and start prints remotely: You can control every aspect of your printer over the network, so you can preheat the hot end and heat bed from any device with an Internet connection. 

  • Monitor prints remotely: As your printer runs, you can monitor the temperature levels remotely to make sure everything is running smoothly. You can even plug in a webcam and visually keep an eye on your printer. 

  • More reliable printing: With OctoPrint on a Raspberry Pi, you don’t have to worry about your computer restarting or hanging mid-print and ruining the job. 

In our opinion, these benefits are well worth it and make OctoPrint a significant upgrade to your 3D printing setup. It will unlock new functionality for your Creality printer and give you the ability to safely monitor your prints remotely.

What To Buy

Note: Creality Experts receives a commission for items you purchase from this page, at no additional cost to you. For more information, please see our affiliate link policy.

To set up OctoPrint with your Ender 3 or CR-10, you’ll need to purchase a few accessories. These will let you run OctoPrint without a computer, so you can keep your 3D printer in a different room or turn your computer off during long prints. You can purchase everything you need from Amazon, and we can tell you exactly what you need.

Recommendation: Raspberry Pi 4 Starter Kit

You’ll need a few different items, all of which are included in the recommended starter kit above, except for the microSD card reader. But if you want to comparison shop or already have some of these items, here are the individual products we recommend:

  • Raspberry Pi 4

  • USB Power Supply

  • microSD Card

  • SD Card Reader

The Raspberry Pi is the best way to use OctoPrint with your Creality 3D printer. It’s a tiny computer that draws very little power, so you can set it next to your printer and leave it on 24/7. There are several models of the Raspberry Pi. The newest and most powerful is the Raspberry Pi 4.

You’ll need a USB power supply for the Raspberry Pi as well. The starter kit comes with a power supply, but you can also find these on Amazon easily. 

Finally, you’ll need a microSD card and a way to access it with your computer so you can load the OctoPrint software on it. Most microSD cards come with an SD card adapter, so you can purchase an SD card reader for your computer (link) assuming you don’t have one built-in. We recommend a microSD card of at least 8GB in size.

How To Set Up OctoPrint

Setting up OctoPrint on your Raspberry Pi is a a simple 4-step process:

  1. Load the OctoPi image onto the microSD card.

  2. Configure network settings.

  3. Install the micro SD card in the Raspberry Pi and plug the Raspberry Pi into the printer.

  4. Log in to OctoPrint and configure settings.

We’ll cover these steps in detail and you’ll be up and running in no time.

Step 1: Load the OctoPi image onto the microSD card

Although you can install OctoPrint onto an existing Raspberry Pi software installation, if you’re starting fresh it is easiest to image the micro SD card with a version of the Raspberry Pi software that already includes OctoPrint. There is a micro SD card image called OctoPi that accomplishes this.  

You can download OctoPi from here. This will download a .zip file that you will need to extract to a directory on your computer.

You’ll also need software to install the image onto the micro SD card—you can’t just copy the files onto the card. Fortunately, you can do this with a free program called Etcher.

Once you have the OctoPi image and Etcher downloaded onto your computer, you’re ready to flash the image onto the micro SD card. Simply insert the micro SD card into your card reader. Then, open Etcher, click Flash from file, and select the OctoPi .img file you downloaded. Then click Select target and select your microSD card. Click Flash to load the image onto the micro SD card.

Note that Etcher might eject the microSD card after flashing the image. If it does, remove and reinsert the microSD card.

Step 2: Configure network settings

Once you plug in the Raspberry Pi, you’ll want to be able to connect it to your network so you can access OctoPrint remotely. Although you could plug in a mouse, keyboard, and monitor to the Raspberry Pi to set up your network settings, there’s a much easier way. You can add your network settings to a file on the micro SD card so they can be used by the Raspberry Pi when it boots up.

In the file browser on your computer, open the micro SD card and open the boot directory. Then, open the “octopi-wpa-supplicant.txt” file. In this file, you can configure the SSID and PSK (password) of your wireless network under the “WPA/WPA2 Secured” section. This will allow the Raspberry Pi to connect to your WiFi network when it boots up.

Important Note: You will need to remove the “#” character from the beginning of each line in the WPA/WPA2 Secured Network section, not including the line with the “WPA/WPA2 Secured Network” text. It should look like the following:

If you scroll down in the file, you’ll also see a set of lines that each correspond to a country. Ensure that the line for your country does not have a “#” in front but that all other countries do.

Once you have entered your network settings and removed the “#” characters, save the file and eject the micro SD card.

Step 3: Connect the Raspberry Pi

At this stage, you are ready to plug in the Raspberry Pi and boot it up. 

First, insert the micro SD card into the card slot on the Raspberry Pi. You’ll need to leave this card inserted into the Raspberry Pi since it contains the software that the Raspberry Pi needs to run.

You’ll need to use the USB power supply to power the Raspberry Pi, so plug it into an electrical outlet near your 3D printer and connect it to the small USB power input on the side of the Raspberry Pi. You should see an LED light up on the Raspberry Pi, indicating that it has power. This will also cause the Raspberry Pi to begin its boot process.

Finally, connect the Raspberry Pi to your 3D printer using a USB cable. You can use the USB cable that came with your Creality printer (the Ender 3, CR-10, and all other Creality printers come with a blue cable for this purpose), or if you don’t have the cable, you can buy one from Amazon here.

Step 4: Configure OctoPrint settings

In a web browser on your local network, type octopi.local in the address bar and hit Enter. This will bring up the OctoPrint user interface. Since this is the first time you’ve launched OctoPrint, you’ll see a setup wizard. Click Next to begin the setup process.

On the next screen, you’ll have the opportunity to set up a username and password for your printer. The setup wizard explains why this is a good idea. Go ahead and set a username and password and click Keep Access Control Enabled. Then click Next to continue.

The next three screens allow you to make choices about sending anonymous usage information to the OctoPrint developers, enabling a connectivity check feature where OctoPrint can check whether it has Internet access, and enabling a plugin blacklist to prevent you from installing plugins that are known to be buggy. We recommend enabling all of these options, but you can choose whether to enable or disable each one as you go through the wizard. Click Next on each of the screens once you’ve made your choice.

On the next screen, you’ll have the opportunity to set up a default printer profile. These settings are important because of the features in OctoPrint to move your printer in the X, Y, and Z axes.

  • In the first General section, you can set your printer name and model to anything you want.

  • In the Print bed & build volume section, the main setting you need to change is the width, depth, and height of the printer. Set these appropriately for your Creality machine. Here are the settings for a few of Creality’s most common printers:

    • Creality Ender 3 or Ender 3 Pro: Width 220, Depth 220, Height 250

    • Creality CR-10: Width 300, Depth 300, Height 400

  • In the Axes section, you can change the maximum movement speed for each of the printer axes. You shouldn’t need to change any settings here.

  • In the Hotend & extruder section, you can set the nozzle diameter of your printer. For a Creality machine, this will be 0.4mm from the factory.


Once you have configured all of these settings, click Next. Then click Finish to exit the wizard.

Using OctoPrint

To use OctoPrint, you can always navigate to octopi.local in a Web browser on your local network. It’s also possible to access OctoPrint remotely--you can forward this address to an outside port on your router, or follow the instructions here for other methods of enabling remote access.

When you log in on the user interface with the username and password you chose during setup, you’ll see the main OctoPrint interface.

On the upper left side, you’ll see connection settings for connecting to your Creality 3D printer. You shouldn’t need to change anything here; if you click Connect and have the USB cable plugged into your printer, you should see the State change to Connected.

After a few moments, the temperature graph on the right side will start to show the current temperature values of your printer’s hot end and heat bed. This is extremely useful--you can tell whether your printer is fully heated, and can also troubleshoot issues related to the hot end with this graph. For example, if you see large fluctuations in the temperature, it might indicate that the thermistor in your hot end needs to be replaced. You can set new target temperatures for the hot end and heat bed using the controls just below the graph.

On the lower left side, you’ll see a list of files, and an Upload button beneath the list. You can use this to upload .gcode files for your Creality printer. Once you’ve uploaded a file, you can click the file name to select it, and then click the Print button above the file list to begin printing from that file. As you can see, this is much more convenient than running back and forth with an SD card.

Next Steps

OctoPrint has an enormous amount of settings and functionality, so you can use it to expand your 3D printing capability in many more ways than what we have covered here. For example, you can set it up to use Cura to automatically slice STL files that you upload. You could configure it to control a smart outlet so that your printer powers off after a successful print. You can use a mobile application such as OctoClient to monitor your prints from anywhere you can get an Internet connection. We hope to provide guides for some of these options soon, but in the meantime you can always search online for OctoPrint and take advantage of the knowledge provided by its active community of users. Enjoy printing from your couch!

10 reasons to use OctoPrint for 3D printing

3DPrintStory