Installing OctoPrin...

Installing OctoPrint and Octoprint-TFT to control your 3D Printer, with a touch screen!  


Member Admin
Joined: 6 months ago
Posts: 162
07/01/2019 8:24 pm  

I recently installed and setup OctoPrint on a Raspberry Pi B3 + to use with my new Ender 3, I figured I would share a write up I made as I went through the install and configuration.

Also, I am using the following hardware


First, we need to download OctoPi and create a MicroSD image from their downloads.

Once you have the most recent version of OctoPi downloaded and ready, insert the MicroSD card you will be using into your computer and upload the image to it.

A popular and simple tool to do so is Etcher.

Below is taken from the guide, under the Getting Started with OctoPi.


Please follow these steps after downloading
  1. Unzip the image and install the contained .img file to an SD card like any other Raspberry Pi image.
  2. 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.

    Note: This changed with OctoPi 0.15.0, earlier versions had you edit octopi-network.txt which has a different format. This old method is no longer supported and the contents of this file will be ignored. Just use octopi-wpa-supplicant.txt.

    Please also refer take a look at the full WiFi setup guide in the FAQ that also includes Troubleshooting tips.
  3. Boot the Pi from the card.
  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”. Change the password using the passwd command. You do not need to expand the filesystem, current versions of OctoPi do this automatically.
  5. Access OctoPrint through  http://octopi.local  or  http://<your  pi's ip address>. https is available too, with a self-signed certificate.
Please also refer to OctoPi’s README, especially the “How to use it” section.

Once your Raspberry Pi is booted and you are able to SSH into your device, we can now start to configure the touch screen, and other software.

To SSH or connect to your device, first be sure to complete the WiFi setup above, or connect with an ethernet cable into your Raspberry Pi.
You can then use Putty as an SSH client to connect to the Raspberry Pi / OctoPi installation.
The name you will connect to is octopi.local

First lets run some updates to get everything ready.

sudo apt-get update
sudo apt update
sudo apt dist-upgrade
sudo apt clean
sudo reboot

We also need to setup autologin, to do so run

sudo raspi-config

And navigate to Boot Options - Desktop CLI - and choose Console Auto Login


For my specific LCD, I was able to locate the manual and other details here


You can download and install the files with the following

git clone 

cd LCD-show/

sudo chmod +x LCD35-show

sudo ./LCD35-show

The device will reboot, once it's booted we can log back in and continue.

Next we can rotate the display with the following command.

cd LCD-Show
sudo ./LCD35-show 270

Reboot your Raspberry Pi and make sure you get video on your LCD.

If your screen is not rotated correctly with the above command, do the following.

sudo nano /boot/config.txt

And change the line for your display to add :rotate=270 as shown below


Now that we have our LCD functional and working, lets install a user interface.

First is the X desktop environment, then Touch-TFT and its requirements


sudo apt-get install libgtk-3-0

sudo apt install xserver-xorg xinit xserver-xorg-video-fbdev


Once X is installed, we can follow up with the installation of OctoPrint-TFT

sudo dpkg -i octoprint-tft_0.1.2-1.stretch_armhf.deb

sudo systemctl set-default


Lastly we need to remove the 99-fbturbo.conf file from our Xorg directory.

sudo mv /usr/share/X11/xorg.conf.d/99-fbturbo.conf /usr/share/X11/xorg.conf.d/99-fbturbo.conf.old

Now on reboot OctoPrint-TFT should load and start attempting to connect


Next we can enable the Raspberry Pi camera, to do so get into the raspi config menu;

sudo raspi-config

Navigate to option 5 Interfacing Options, and enable the Camera under option 1.

I also like to disable the camera LED, this can be done with the following;

sudo nano /boot/config.txt

and add the following line


On next reboot the camera LED will be disabled.


I also modified my Raspberry Pi to connect to a network share housing gcode files for my printer, to do so I did the following.

sudo nano /etc/fstab

And added the following line (modify for your network and setup)

//server/share/Data/3D/gcode /home/pi/.octoprint/uploads/_network cifs username=pi,password=raspberry,domain=workgroup 0 0


//server will be the computer your network share is located and /share is the shared folder.

Some users have reported having to specify their cifs version for this to work correctly.
I've also noted, uploading files to the shared folder requires a refresh of the WebUI of OctoPrint for them to display in the file menu if you have navigated to it in your current session.


Upon reboot, it will mount my network share from \\Server\share to the Ocotprint Uploads folder on my Raspberry Pi.


This topic was modified 6 months ago 8 times by CrackedConsole
This topic was modified 5 months ago 26 times by CrackedConsole
This topic was modified 3 months ago by CrackedConsole
This topic was modified 2 months ago 2 times by CrackedConsole

Member Admin
Joined: 6 months ago
Posts: 162
17/01/2019 10:06 am  

Trouble Shooting

A full list of issues can be found in the official OctoPrint-TFT Github



OctoPrint-TFT fails to load.

Check the following files


And look for any invalid characters or formatting of the text


Member Admin
Joined: 6 months ago
Posts: 162
20/01/2019 10:32 pm  

A Quick video on how I am powering my Raspberry Pi running OctoPrint.

Member Admin
Joined: 6 months ago
Posts: 162
16/03/2019 11:18 pm  

I came across a discussion on Social Media regarding OctroPrint-TFT that linked backed to a fork of the Original.

It looks like in this build it includes a working fix for the screen blanking issue that plagues the current build.
I will be testing this build and and looking to utilize it and update the instructions (or supplement them for an option)


(Place holder for updated v2 instructions to utilize the darksid3r build as an additional option)

This post was modified 2 months ago by CrackedConsole


Please Login or Register