Raspberry Pi Tips¶
Choose a Raspberry Pi guide by the task you want to complete, then check the requirements for your board and OS version. The Tips sidebar groups practical guides, including kernel and filesystem topics, by purpose. For a fault rather than a new project, start with Troubleshooting.
For a learning path through access, updates, exposure and recovery, use Security. Its CVE case studies are optional examples. Practical hardening and TPM guides remain in the categories below.
Choose a Raspberry Pi topic¶
| Your goal | Start here |
|---|---|
| Run local AI or use a camera | AI & Machine Learning |
| Connect remotely or build a smart home | Home Network & Smart Home |
| Use GPIO, USB or a microcontroller | Hardware, USB & IoT |
| Manage, secure or tune the OS | System Administration & Security |
| Build storage or container services | Storage, Boot & Containers |
| Configure browsers or desktop tools | Productivity & Customization |
| Explore Linux internals | Kernel, Filesystems & Sandboxing |
| Run games and emulators | Gaming & Emulation |
Recently updated guides¶
Revised on 22 November 2026:
- Bookworm to Trixie Migration — Verify the new disk and package sources, then check access, files, containers, and scheduled jobs before cutover.
Revised on 6 November 2026:
- llama.cpp Mlock Errors — Separate invalid flags, lock refusals and OOM evidence; inspect the running process before changing a service limit.
Revised on 5 November 2026:
- Your First SSD1306 OLED Frame — See the expected greeting, follow the four-wire signal map and display a still frame before trying animation.
Revised on 4 November 2026:
- Static IP or DHCP Reservation — Choose the method, plan an unused address, test a separate profile and keep the original connection for rollback.
Revised on 3 November 2026:
- NetworkManager: Read the Result Before Repairing — Interpret device states, addresses, selected routes and name lookups, then check recovery and a fresh SSH login.
Revised on 30 October 2026:
- Raspberry Pi Power Saving — Measure task energy, try reversible changes and distinguish running power from model-specific shutdown and wake options.
Revised on 28 October 2026:
- USB Ethernet: Setup and Reconnection — Pi 4B/Linux USB SSH test, unmanaged interfaces, and manual reconnection after reboot.
- USB Gadget Not Detected — Separate cable, controller, host detection, interface management, IP and SSH checks.
- USB HID Keyboard Experiment — Temporary keyboard configuration, input precautions and cleanup; HID hardware testing is still pending.
- USB Mass Storage — Use a new disposable image, check ownership and mounts, and plan safe detach and recovery.
- SSH and Firewall Hardening — Verify key-only access, review SSH policy and prepare recovery before changing firewall rules.
- AI HAT+ 2 and Local LLMs — Start with the model API, then consider optional WebUI access, persistent data and service startup.
- NetworkManager and nmcli — Check a missing command or inactive service before changing a working connection.
All Articles by Category¶
AI & Machine Learning¶
- llama.cpp Memory-Lock Errors — Check load modes, limits and OOM evidence.
Harness the power of artificial intelligence on your Raspberry Pi with these practical AI implementation guides.
- llama.cpp: First Response, Mlock and Benchmarks — Build on your Pi, download and verify a small GGUF model, generate one response, then try benchmarks and a local API.
- TensorFlow Lite Object Detection — Real-time object detection with pre-trained models and Coral USB Accelerator.
- Offline Voice Assistant — Build a Trixie-ready sherpa-onnx pipeline with measured audio, ASR, keyword, TTS, and safe action stages.
- Image Classification System — Implement real-time image classification for plant identification, quality control, and more.
- AI Smart Security Camera (YOLOv8) — Build an intelligent surveillance camera utilizing YOLOv8 object detection and Discord webhook notifications.
- Self-Hosted Local AI NVR (Frigate) — Build a local AI NVR using Frigate and Google Coral TPU to track objects on RTSP cameras without cloud latency.
- Edge AI: Hailo-8L NPU & YOLOv11 — Offload matrix calculations to the dedicated Hailo-8L NPU for high-frame-rate real-time YOLOv11 inference.
- Local AI Email Assistant (Ollama) — Build a private email agent fetching emails via IMAP and generating summaries using local LLMs.
- Llama 3.1 & Open WebUI RAG — Deploy Llama 3.1 locally with Ollama and implement offline PDF-based RAG using LangChain.
- Coral TPU Face & Object Recognition — Run high-frame-rate real-time object detection with Google Coral USB TPU and local Frigate NVR.
- YOLOv8 Vulkan GPU Acceleration — Accelerate YOLOv8 inference to 30 FPS using Pi 5's internal GPU via the NCNN framework.
- Camera Setup and Troubleshooting: rpicam and Picamera2 — Configure current camera tools, migrate from legacy commands, and diagnose common camera failures.
- AI HAT+ 2: Local LLMs and VLMs — Follow the Pi 5/Hailo-10H API workflow, then optionally add Open WebUI; required hardware is not yet tested for this guide.
- Ultralytics YOLO with OpenVINO — Export and deploy YOLO on the Raspberry Pi Arm64 CPU with model caching and camera inference.
- Raspberry Pi AI Accelerator Comparison — Compare Pi 4 and Pi 5 options, including Coral, Hailo and Sixfab DEEPX, by model compatibility and full video throughput.
Home Network & Smart Home¶
- Secure VNC on Wayland — Choose a remote desktop path for headless systems.
- Pi 5 Headless First Boot — Check first-boot networking and SSH.
- NetworkManager Update Errors — Identify the package failure while preserving remote access.
Build a secure private network, automate your home, and block advertisements at the network level.
Home Lab Learning Order
Choose your stage: First setup with a monitor, install without a monitor, diagnose a failed connection, or add remote access to a working Pi. The connection route map explains which procedure fits; these are alternatives, not a required reading sequence.
Intermediate: Add Docker Compose and Nginx Proxy Manager, Pi-hole and Unbound, and the Monitoring Dashboard.
Advanced: Build Btrfs RAID 1, a Multi-Node K3s Cluster, and Cloudflare Tunnel access.
- Home Assistant: Your First Automation — Choose OS or Container and use a virtual switch to test a notification and a door-left-open reminder.
- Network-Wide Ad Blocker (Pi-hole + Unbound) — Block ads and trackers for all network devices, and configure Unbound as a secure recursive DNS resolver.
- Pi-hole + Unbound on Docker Compose — Run Pi-hole and Unbound recursive DNS inside containerized Docker environments.
- Tailscale Remote VPN — Configure Tailscale VPN to access your home server from anywhere without opening ports or configuring Dynamic DNS.
- VPN Setup Guide — Establish standard private VPN servers for secure encrypted remote connections.
- Raspberry Pi Connect Complete Guide — Securely access a Pi desktop or shell from a browser without opening router ports.
- Raspberry Pi Connect Remote Updates — Package Trixie OTA scripts, deploy through Connect, monitor failures, and plan A/B rollback.
- Headless and Networking Guide 2026 — Choose Ethernet, Wi-Fi, USB Gadget, Connect, Tailscale, or VNC and retain a recovery path.
- Raspberry Pi NetworkManager and nmcli — Diagnose Wi-Fi, DNS, static IP, SSH lockouts, and NetworkManager update failures on Bookworm or Trixie.
- WiFi Access Point Setup — Create a routed NetworkManager hotspot or plan a bridged access point.
- Choose Connect, VNC, RDP or SSH — Match the method to your task, verify the session and diagnose connection failures safely.
- Secure Self-Hosting (Docker Compose + NPM) — Combine Pi-hole, Vaultwarden, and Nginx Proxy Manager on a single Pi using Docker Compose and SSL certificates.
- Static IP Configuration — Prefer a DHCP reservation or plan, test and roll back a separate NetworkManager profile.
- Secure Expose: Cloudflare Tunnel — Expose local Nextcloud or Jellyfin servers to the web without port forwarding or risking residential IP exposure.
- Secure Connection (WireGuard + Pi-hole) — Access your home network securely on-the-go and block ads via virtual VPN tunnels.
- AdGuard Home & Unbound over TLS — Protect privacy and block ads net-wide using AdGuard Home and recursive DNS over TLS.
- Zigbee to Home Assistant Container — Pair Zigbee sensors and auto-discover them locally using Zigbee2MQTT and Docker Compose.
- WireGuard VPN Server with Web UI — Host a local WireGuard VPN and manage client peer profiles easily using QR codes.
- Advanced Home Assistant Dashboard Customization — Install HACS and write custom CSS card modifications to adjust card layout and appearance.
Hardware, USB & IoT¶
Choose a USB guide¶
| What you need | Start here |
|---|---|
| SSH over USB on a supported Trixie system | Supported USB Ethernet package |
| Explicit addressing on a custom or older image | Manual dwc2 and g_ether setup |
| No USB device, missing usb0, or a failed connection | USB gadget diagnostics |
| Send keyboard input to a host you control | Temporary HID keyboard experiment |
| Present a disposable image as a removable drive | USB mass-storage setup |
| Combine several USB functions | Composite gadget design |
Use the USB mode comparison if you are still choosing a function. Check model, connector and power requirements; these setups can compete for the same device controller.
Hardware and USB articles¶
- SSD1306 OLED on Raspberry Pi — Part 7 of C++ Hardware Programming: a four-wire signal map, I2C checks and your first frame.
- USB Gadget Missing usb0 — Diagnose USB, network and SSH layers.
- Pico W & MQTT Sensor Node — Program a Raspberry Pi Pico W to broadcast wireless sensor telemetry over MQTT.
- USB Gadget Mode Comparison — Compare Ethernet, HID, MIDI, mass storage, and composite designs by goal, model, host, and safety requirement.
- USB OTG Mass Storage — Create a disposable backing image, start read-only, and manage host/Pi ownership and safe detach.
- USB Gadget Mode for SSH — Use the supported Trixie package for USB Ethernet, SSH, and optional host internet sharing.
- Raspberry Pi dwc2 USB Ethernet Gadget — Check
hostversusperipheral, verify the running USB role, and configure point-to-point SSH on a custom image. - USB HID Keyboard Experiment — Configure a temporary keyboard and clean it up; the guide has no mouse example or HID hardware verification yet.
- USB Composite Gadget (ConfigFS) — Emulate multiple USB device types (e.g. storage, serial, ethernet) over a single physical cable.
- High-Speed GPIO Control in C++ — Compare modern
libgpiodwith direct register mmap access to toggle GPIO pins at maximum CPU frequencies. - Rust on Raspberry Pi: Board Info and GPIO — Read the board model with RPPAL, blink an LED with Cargo, and build an ARM64 binary on Linux.
- USB MIDI Controller — Build custom MIDI instruments and controllers using the USB OTG controller.
- Fix I2C on Old Models — Troubleshoot I2C configuration and communication errors on older Raspberry Pi models.
- Matter Smart Home Sensor Node — Build an open-standard Matter device on Pico W and integrate it locally into Home Assistant.
- Pico 2 W and RP2350 Getting Started — Flash MicroPython, connect Wi-Fi securely, test GPIO, and benchmark RP2350 workloads.
- Touch Display 2 Size Comparison and Setup — Choose between 5, 7, and 10-inch displays and configure DSI, rotation, touch, and kiosk mode.
- LoRaWAN Gateway with ChirpStack — Build a standards-compliant SX1302/SX1303 gateway and measure real-world coverage.
- Compute Module 5 Setup — Flash eMMC with rpiboot, configure NVMe, and validate carrier-board power and cooling.
Kernel, Filesystems & Sandboxing¶
- OverlayFS Changes Lost After Reboot — Separate temporary writes from persistent maintenance.
Explore advanced Linux OS kernels, file systems, security wrappers, and observability tools.
- Raspberry Pi eBPF and tcpconnect-bpfcc — Install BCC, check kernel headers, and trace outgoing TCP connections by PID or port.
- Network Namespaces & VRF — Create isolated virtual networks and custom routing tables inside single host OS namespaces.
- inotify - Filesystem Monitoring — Implement real-time file access monitoring and trigger automatic event scripts.
- cgroups v2 & systemd-run — Restrict CPU/memory usage and build custom process sandboxes.
- OverlayFS — Try a temporary overlay and check which files will persist before enabling a read-only root.
- SD Card Write Reduction — Diagnose writes, limit logs, move disposable data, and decide when OverlayFS is appropriate.
- FUSE - Filesystem in Userspace — Mount custom and cloud file systems easily using FUSE drivers.
- Hardware Security Module (TPM) — Secure device identity and data with hardware-enforced TPM modules and dm-verity.
- TPM 2.0 Module Selection — Select a compatible module and prove Linux driver binding before provisioning.
- TPM2 LUKS2 Auto-Unlock — Enroll a TPM token on an encrypted test data partition while retaining recovery access.
- Real-Time PREEMPT_RT Kernel — Patch, configure, and compile a hard real-time kernel on Raspberry Pi 5 for low-latency robotics loops.
- Btrfs Storage Optimizations — Migrate to Btrfs to use transparent zstd compression and automated read-only snapshots.
- Btrfs RAID 1 Redundant Storage — Create a self-healing RAID 1 disk array on Raspberry Pi 5 with transparent zstd compression.
System Administration & Security¶
- Undervoltage and get_throttled — Separate current power faults from historical flags.
- raspi-config Errors — Check packages, permissions, terminal and command options.
- NetworkManager Wait-Online Slow Boot — Inspect the dependency and connection delaying boot.
- CPU Isolation and Task Affinity — Understand scheduling boundaries before tuning.
Manage logs, monitor system metrics, configure power systems, and implement best practice server security.
- Fix sudo Password Prompts on Trixie — Diagnose authentication failures, set an admin password, repair automation, and apply a narrow sudoers rule when required.
- Security Hardening — Review SSH, firewall, account, and update settings to protect your server from unauthorized logins and attacks.
- Raspberry Pi OS Trixie Migration Guide — Move safely from Bookworm with backups for services, Docker data, and remote access.
- Portable Pentesting Tool (Kali Linux) — Install Kali Linux, enable monitor mode/packet injection, and perform wireless security audits.
- Systemd Daemons — Configure custom scripts and binaries to run as managed background services.
- Discord Bot 24/7 Hosting — Run your Discord bot continuously using Systemd daemons or containerized Docker Compose.
- Automated Backup Strategies — Establish reliable automated snapshot and replication schedules.
- CPU Temperature and Cooling — Read CPU temperature over SSH, interpret clock and throttling readings, and check when the Pi 5 fan should spin.
- Reproducible Raspberry Pi Benchmarks — Measure power, temperature, boot, storage, network, and AI performance with repeatable raw-data protocols.
- Raspberry Pi OS Performance Optimization — Route each performance symptom to a measured, reversible optimization.
- Memory Pressure, ZRAM, and OOM Diagnosis — Correlate PSI, swap traffic, compression, latency, and OOM events.
- Performance Monitoring (Prometheus & Grafana) — Set up Prometheus, Grafana, and Node Exporter using Docker Compose to visualize real-time resource usage and CPU temperature.
- Power Saving: Measure, Change, Restore — Compare idle/task energy and review model-specific shutdown and wake behavior.
- Power Consumption and Cost Calculator — Estimate daily, monthly, and annual energy from measured operating states.
- CPU Frequency and Governors — Compare idle and loaded clock speeds, then check the CPU policy, temperature, and power flags.
- ZRAM Swap Setup and Benchmark — Identify Trixie's
rpi-swap, check whether ZRAM writes back to disk, and measure the workload before tuning. - Boot Time Optimization — Read real Pi 4 boot timings and measure when an SSH client can actually log in.
- Headless Setup Guide — Set up SSH in Imager, find your Pi on the network, and verify the first login without a monitor.
- Headless Setup Troubleshooter — Diagnose boot, DHCP, mDNS, SSH, key, host-identity, and USB Gadget failures by symptom.
- Home Lab Monitoring Dashboard — Build a unified monitoring dashboard with Netdata, Uptime Kuma, and Grafana using Docker Compose.
Storage, Boot & Containers¶
Configure Docker runtimes, mount external drives, and boot from high-performance solid-state drives.
- NVMe SSD Boot (Pi 5) — Enable PCIe Gen 3 modes and configure SSDs as primary boot devices on the Pi 5.
- Raspberry Pi NAS with Samba — Create a private file share, test it from another computer, and move it to an existing USB drive.
- Home Media Server (Plex & Jellyfin) — Set up local Jellyfin playback, verify Direct Play with a short clip, and add a USB library.
- Private Cloud Storage (Nextcloud) — Install Nextcloud using Docker Compose to build your own private Dropbox/Google Drive alternative with automated photo backups.
- External USB Storage — Migrate the OS root filesystem (rootfs) to faster external USB drives.
- I/O Scheduler Optimization — Tune kernel disk schedulers to maximize read/write performance of slow SD cards.
- Docker on Raspberry Pi — Compile, configure, and scale containerized environments efficiently.
- Lightweight Kubernetes Cluster (k3s) — Set up a multi-node Kubernetes cluster on Raspberry Pi using Rancher's lightweight k3s distribution.
- CI/CD Pipeline with Docker & GitHub Actions — Configure a self-hosted GitHub Actions runner to automate native Docker deployments on push.
- Nginx FastCGI Caching — Optimize web performance on Raspberry Pi 5 by caching dynamic FastCGI queries in RAM.
- Multi-Node K3s Cluster — Deploy a lightweight Kubernetes cluster on Raspberry Pi 5 with host-port ingress and local DNS routing.
- Self-Hosted GitHub Actions Runner — Set up a containerized self-hosted GitHub runner to automate native Docker builds.
Productivity & Customization¶
Enhance your desktop usability, customize inputs, and troubleshoot old legacy components.
- Chromium Sync and Google Chrome ARM64 — Choose website sign-in, Google browser data, or bookmark/password sync; install Chrome once and verify the result on another device.
- Update or Uninstall Google Chrome ARM64 — Update through APT, repair repository failures, preserve profiles, uninstall safely, or switch browsers.
- Fix Google Chrome ARM64 Errors — Diagnose 404, ARMHF/AMD64 mismatch, APT, startup, profile, sandbox, and Sync problems.
- Chrome vs Chromium vs Firefox Benchmark — Compare startup, PSS memory, page loads, video, stability, and Sync with one protocol.
- Remapping Caps Lock to Control — Reconfigure input maps to optimize typing ergonomics for development.
Gaming & Emulation¶
Turn your Raspberry Pi 5 into a high-performance retro gaming console with Vulkan hardware acceleration.
- PS2 & Sega Saturn Emulation (Vulkan) — Check emulator compatibility and measure performance for the games you want to run.