Ditch the non-SSH install instructions

Yeah, the automatic install is effortless, but if you plan to do literally anything else other than wirelessly send prints through your pi to your printer, you will be forced to know how to SSH into your pi and edit things. But virtually no good resources exist that tell you step-by-step how to do this. Most of them start off by telling you to do many things a newbie has no clue how to do, with no hint as to how to do them. So you start searching for how to do those things and run into the exact same problem: Tons of resources that assume you already know how to do the thing, or don't lay things out step-by-step.

Many tell you to start by plugging a keyboard and monitor into your Pi. Imagine being a newbie and having no clue how to do the 50 things you're being told to do in order to do something simple like enable a webcam, and the instruction start off by telling you to unhook everything you just unhooked, take your peripherals from your desktop computer, and hook them up to the pi so you can edit a setting. With no hint that you can login remotely.

This has been my previous two days. Every little thing I try to get working tells me to go do 50 other things I don't know how to do and the single most common denominator that keeps showing up is accessing the Pi via SSH. Which is a step that the OctoPrint instructions explicitly allow you to skip and rely on an automatic approach. This leaves you lost, confused, and frustrated later when you try to do absolutely anything else and keep getting spammed with "login via SSH, login via SSH, login via SSH" all by sources that refuse to tell you how to actually do it without making it a 30+ minute obstacle.

Just start newbies off on the right foot and tell them, step-by-step, how to use SSH to setup their pi for OctoPrint.

Typically it's just for one-off specific things that this is recommended I think, and mostly with advanced setups or for troubleshooting problems. In most cases any of the files you need to edit (ie octopi.txt for webcam changes) can be edited prior to putting the SD card into the pi. In most cases the pi imager setup process is painless and not all users need to SSH to the pi (unless you didn't change the default password). It also takes less than a minute to search and find out how to SSH to a pi.

1 Like