Raspberry Pi Tutorial

A practical tutorial for setting up Raspberry Pi systems, building software on top of them, and turning ideas into reliable projects.

Who This Is For

People who installed Raspberry Pi OS once and want to build something real on top of it.
Developers who want a small Linux host for sensors, dashboards, kiosks, or self-hosting.
Hobbyists who want a clear path from "I bought a Pi" to "I have a project running 24/7 that I trust."

File	Description
00-index.md	Course map, hardware checklist, and project paths
01-choosing-a-raspberry-pi.md	Picking the right board, accessories, and starter kit
02-imaging-boot-and-remote-access.md	Installing Raspberry Pi OS, first boot, SSH, and remote access
03-linux-cli-files-networking.md	Everyday Linux skills, packages, files, logs, and networking
04-python-and-hardware-control.md	Python workflow, GPIO libraries, automation scripts, and services
05-electronics-gpio-and-sensors.md	Safe wiring, sensors, displays, motors, and hardware patterns
06-services-web-apps-and-apis.md	Dashboards, APIs, background workers, and kiosk-style apps
07-containers-automation-and-remote-management.md	Docker, scheduled jobs, fleet management, and deployment habits
08-computer-vision-audio-and-edge-ai.md	Cameras, microphones, streaming, local inference, and AI ideas
09-security-backups-and-reliability.md	Hardening, updates, monitoring, backups, and recovery
10-project-ideas-and-build-roadmaps.md	Project ideas and step-by-step build roadmaps

How to Use This Tutorial

Read sequentially the first time unless you already know Linux basics.
Type out the examples on a real Pi. Reading is not the same as wiring.
Pick one project from chapter 10 early and adapt every later chapter to it.

Quick Reference

Essential Commands

# Update and upgrade everything
sudo apt update && sudo apt full-upgrade -y

# Connect from another machine
ssh your-user@pi-lab.local

# Check temperature, memory, storage
vcgencmd measure_temp
free -h
df -h

# Inspect a service
systemctl status my-app
journalctl -u my-app -f

Hello World: Blink an LED

from gpiozero import LED
from time import sleep

led = LED(17)

while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)

Common Patterns

# Read CPU temperature from Python
from subprocess import check_output

def cpu_temp_c() -> float:
    raw = check_output(['vcgencmd', 'measure_temp'], text=True)
    return float(raw.split('=')[1].split("'")[0])

# Sync a project from your laptop to the Pi
rsync -av --delete project/ your-user@pi-lab.local:/home/your-user/project/

# Minimal systemd unit for a Python service
[Unit]
Description=Garden Monitor
After=network-online.target

[Service]
User=your-user
WorkingDirectory=/home/your-user/projects/garden-monitor
ExecStart=/home/your-user/projects/garden-monitor/.venv/bin/python -m app.main
Restart=always

[Install]
WantedBy=multi-user.target

Prerequisites

Basic computer literacy and willingness to use the terminal.
A Raspberry Pi or a clear idea of which model you want to buy.
A monitor and keyboard for first boot, or comfort setting up SSH.

Quick Start

If you want the fastest path to building useful things, read these first:

What This Guide Helps You Do

After finishing this tutorial, you should be able to:

choose the right Raspberry Pi for a specific job instead of overbuying
install and maintain Raspberry Pi OS confidently
write Python software that talks to pins, sensors, cameras, and services
ship small but real apps like dashboards, kiosks, APIs, and automation boxes
design projects that are secure, recoverable, and stable over time
turn fun ideas into staged builds you can actually finish

Chapters

About this tutorial