Skip to main content

Introduction

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.

Please note that the Raspberry Pi Zero W is not recommended since severe performance issues were observed, caused by the WiFi interface when bandwidth is utilized (e.g. the webcam is streamed), negatively impacting printing results.

Thomas Sanladerer created a great video guide on how to get OctoPi 0.12 up an running.

Video Overview

  1. You can download the latest OctoPi image via the following link.
  2. Download and install Etcher. This will allow you to write the image you just downloaded to the SD card for your Raspberry Pi.
    • Download and install Etcher. This will allow you to write the image you just downloaded to the SD card for your Raspberry Pi.

    • https://etcher.io/

  3. Unzip the image and install the contained .img file to an SD card using Etcher. Do not at any point format the SD from your Operating System, even if prompted to do so - that will break it and you’ll have to start over. Just use Etcher to flash the .img file, that is enough!
    • Unzip the image and install the contained .img file to an SD card using Etcher. Do not at any point format the SD from your Operating System, even if prompted to do so - that will break it and you’ll have to start over. Just use Etcher to flash the .img file, that is enough!

  4. Configure your WiFi connection by editing octopi-wpa-supplicant.txt on the root of the flashed card when using it like a thumb drive.
    • Configure your WiFi connection by editing octopi-wpa-supplicant.txt on the root of the flashed 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.

    • Boot the Pi from the card.

    • Locate the IP address of the device. In most cases, you can open a command prompt on your computer and type "ping octopi.local".

    • Alternatively, if you have a monitor connected to your Raspberry Pi, you can see the IP address on the main boot screen.

  5. 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
    • 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

    • Change the password via “Change User Password”

    • Optionally: Change the configured timezone via “Localization Options” > “Timezone”.

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

  6. Access OctoPrint through http://octopi.local''' or http://<your pi's ip address>'''
Finish Line

insurgus

Member since: 12/09/2019

87,639 Reputation

24 Guides authored

0 Comments

Add Comment

View Statistics:

Past 24 Hours: 1

Past 7 Days: 16

Past 30 Days: 50

All Time: 1,644