This is the easiest way to use OctoPrint on a Raspberry Pi

Download our custom version of OctoPi .

Download the latest version of Raspberry Pi Imager and install it. If you want to use Raspberry Pi Imager from a second Raspberry Pi, you can install it from a terminal using sudo apt install rpi-imager

Then:

• Connect an SD card reader with the SD card inside.
• Open Raspberry Pi Imager and choose the Customized OctoPi.
• Choose the SD card you wish to write your image to.
• Review your selections and click on the Write button to begin writing data to the SD Card.

The latest version of OctoPi is 0.18.0 released on Jan 25, 2021. This version of OctoPi needs to update the serial driver of ch340/ch341.

Unzip the guysoft/OctoPi image and install it to an sd card according to the installation instructions of guysoft/OctoPi.

Log into your pi via SSH or other means

Check if the ch340/ch341 serial driver already exists：

ls /lib/modules/$(uname -r)/kernel/drivers/usb/serial/

Delete it:

sudo rm /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko

The Linux kernel version of OctoPi V0.18.0 is 5.4.79, so we download the corresponding header file installation package.

wget http://archive.raspberrypi.org/debian/pool/main/r/raspberrypi-firmware/raspberrypi-kernel-headers_1.20201126-1_armhf.deb 

（If your Linux kernel version is not 5.4.79, download the corresponding one from http://archive.raspberrypi.org/debian/pool/main/r/raspberrypi-firmware/ ;
Use this command to check which version of your Linux kernel: uname -r）

Install the header file :

sudo dpkg -i ./raspberrypi-kernel-headers_1.20201126-1_armhf.deb

wget http://www.weedo3dprinter.com/lib/exe/fetch.php/firmware/ch341ser_linux-kernel5.4.79.zip
unzip ch341ser_linux-kernel5.4.79.zip

cd ch341ser_linux-kernel5.4.79 && make

sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/
sudo depmod

This installation method is a bit complicated, if you do not have programming skills, we do not recommend you to use this method

Install OctoPrint following the OctoPrint community documents.

If you can connect the printer with OctoPrint, there's nothing more you need to do.

If you can not connect the printer with OctoPrint, continue with section 2 to update the serial driver of CH341:

sudo apt-get update
sudo apt-get install raspberrypi-bootloader raspberrypi-kernel
sudo reboot

sudo apt install raspberrypi-kernel-headers

wget http://www.weedo3dprinter.com/lib/exe/fetch.php/firmware/ch341ser_linux-kernel5.4.79.zip
unzip ch341ser_linux-kernel5.4.79.zip

cd ch341ser_linux-kernel5.4.79 && make

sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/
sudo depmod