A field guide to building a portable, hand-made Raspberry Pi machine — a self-driven device for the age of intelligence. Tools you understand. Hardware you can open. Attention that stays yours.
// the machineOne rugged shell — screen, keyboard, radio, and a Raspberry Pi you fully own. Hand-built, in a weekend.
As intelligence gets cheaper and computing gets rented, metered, and tuned to harvest your attention, a deck you built by hand is a small act of sovereignty. Not nostalgia — agency. You know what's inside it, you can fix it, and it does exactly what you told it to.
A laptop is a sealed box of someone else's decisions. A deck is an open question you answered yourself — every wire, every choice, legible to you.
Standard parts, exposed connectors, a community of plans. When something breaks you open it, not bin it. Longevity is a design value, not an accident.
No feed by default. No notification engineered to pull you back. A deck is calm computing — it waits for you instead of competing for you.
The selfdriven rhythm maps cleanly onto a build. Get Curious to plan it, go Constructive to build it, get Caring to tend and share it, then Chill and actually live with the thing.
Decide what it's for, pick a shape, and choose the right Pi.
Parts list, assembly, flashing, NVMe boot, software loadout.
Back it up, keep it safe, document it, give back to the community.
Make it a calm, offline-first machine that respects your day.
Don't start with parts — start with a question: what is this deck for? The honest answer shapes everything. A pocket terminal for SSH on the train is a different machine than a field laptop for a week off-grid. Pick a shape, then pick the Pi that fits it.
Slips in a jacket. A tiny terminal for writing, SSH, notes, radio. Headless-ish, distraction-free.
The classic. Rugged case, real screen, big battery. Off-grid capable, antenna up, does real work.
Stays home. A self-hosted brain: NVMe storage, a local model, your own services. Power from the wall.
The Pi 5 is the current flagship — quad-core Cortex-A76, PCIe for NVMe, a real-time clock, and the in-house RP1 I/O chip. The 4 GB model is the sweet spot for most decks. Heads up: RAM-driven price rises through early 2026 made the 8/16 GB models noticeably pricier, so size your RAM to the job.
| Board | Best for | Power | Why |
|---|---|---|---|
| Pi 5 · 4 GB RECOMMENDED | Field & everyday decks | ~5–8 W idle, 12–15 W load | PCIe/NVMe, RTC, fast enough for a full desktop. The default. |
| Pi 5 · 8–16 GB | Desk decks, local models | ~5–15 W | Headroom for containers, browsers, a small local LLM. |
| Pi Zero 2 W | Pocket / minimal decks | ~1–2 W | Tiny, sips power, runs for hours. No PCIe, modest CPU. |
| Pi 4 · 2–4 GB | Budget builds | ~6–8 W | Cheaper, lower power, huge HAT compatibility. Still capable. |
| Compute Module 5 | Custom carrier boards | varies | For builders designing their own PCB. Advanced path. |
Curious task — before you buy anything: sketch your deck on paper at 1:1 scale. Trace the keyboard, the screen, the Pi, the battery. You'll discover the real constraint (almost always: where does the battery go?) before it costs you money.
This is the Field Deck recipe — a Pi 5, a 7" screen, a mechanical keyboard, and a battery in a case you can take anywhere. Adapt the parts to the shape you chose. Momentum beats perfection: get it booting on the bench first, then worry about the enclosure.
| Part | Pick | ~Cost (USD) | Notes |
|---|---|---|---|
| Compute | Raspberry Pi 5 · 4 GB | $60–80 | The brain. 8 GB if you want a local model. |
| Cooling | Official Active Cooler | $5 | Not optional on a Pi 5 — it throttles hot without it. |
| Storage | NVMe SSD 256 GB + M.2 HAT+ | $40–55 | Boots faster and lasts longer than an SD card. |
| Backup media | A2 microSD 32 GB | $8–12 | For imaging and a rescue boot. |
| Display | 7" touchscreen (DSI or HDMI) | $45–70 | DSI keeps a USB port free; HDMI is more universal. |
| Keyboard | 60% USB mechanical | $30–60 | Or a salvaged/folding keyboard — peak cyberdeck. |
| Power | UPS HAT + 2× 18650 cells | $30–50 | Use protected cells. Gives clean shutdown + runtime. |
| Enclosure | 3D print (PETG) or rugged case | $10–40 | A Pelican-style case is the classic rugged route. |
| Glue parts | Cables, hub, standoffs, inserts | $15–25 | Short right-angle micro-HDMI→HDMI, M2.5 screws, USB-C. |
| Optional HUD | SDR / OLED / antenna / encoder | $10–40 | RTL-SDR for radio, OLED for a status display. |
Before any screws — flash Raspberry Pi OS (64-bit, the current Debian 13 "Trixie" base) onto your NVMe or SD with Raspberry Pi Imager. Open Edit settings and pre-configure hostname, your user, Wi-Fi, locale, and enable SSH. A headless first boot saves a lot of pain.
# In Raspberry Pi Imager → ⚙ Edit settings, set: hostname: deck username: your-name # no default pi user wifi ssid: your-network enable SSH: on locale: your timezone + keyboard layout
Press the Active Cooler onto the Pi (the spring pins click into the mounting holes; the fan plugs into the 4-pin JST header). Fix the Pi to your base plate or case floor with M2.5 standoffs. Leave clearance for airflow — the cooler pulls air across the board.
Seat the M.2 HAT+ on the PCIe FPC connector and GPIO standoffs, slot in the SSD, and screw it down. Don't power on with a half-seated ribbon — reseat if the SSD doesn't appear later.
Connect the display (DSI ribbon to the DISP port, or a short right-angle micro-HDMI cable), plug in the keyboard via USB, and connect the UPS HAT to the Pi's power input per its instructions. Keep cable runs short and dressed — slack is what cracks connectors in a portable build.
Power on before you close the case. Confirm the screen lights, the SSD is detected, and you can log in. Then bring it current.
sudo apt update && sudo apt full-upgrade -y sudo rpi-eeprom-update -a # latest bootloader firmware sudo raspi-config # display, fan curve, overclock if wanted
Tell the bootloader to prefer the SSD over the SD card. Edit the EEPROM boot order so NVMe comes first, then reboot.
sudo rpi-eeprom-config --edit # set this line, save, reboot: BOOT_ORDER=0xf416 # try NVMe → USB → SD → repeat
Now do the enclosure. Route cables, fit the battery so its weight sits low and central, add heat-set inserts for screws that you'll open again. Leave the ports you actually use accessible — USB-C power, at least one USB-A, the network jack if you have one.
Run it on battery and watch for under-voltage. The Pi 5 is happiest on a 5 V / 5 A (27 W) supply; on a smaller pack it still runs but may limit peripheral current. Stress it for ten minutes and confirm it doesn't throttle.
vcgencmd measure_temp # keep under ~80°C vcgencmd get_throttled # 0x0 = all good dmesg | grep -i voltage # watch for under-voltage warnings
Keep it lean and self-driven — tools that work offline and don't phone home. A starting kit for a deck that's good for thinking, not just scrolling:
sudo apt install -y tmux neovim git ripgrep fzf # terminal workshop sudo apt install -y syncthing # own your sync, no cloud curl -fsSL https://ollama.com/install.sh | sh # local models (8GB+ Pi) ollama run llama3.2:3b # a small model that runs on-device
Constructive task — ship the rough version: get it booting and SSH-able on the bench tonight, before the enclosure is perfect. A deck that works in a cardboard box beats a beautiful case with no guts. You can't refine a thing that doesn't exist yet.
A hand-built machine asks for a little ongoing care — and gives a lot back. Caring here means two things: looking after the deck so it lasts, and looking after the community that made your build possible by giving something back to it.
Caring task — uncredited and useful: when you solve a tricky bit (the boot order, a stubborn screen, a battery fit), write the fix into a public README or a forum reply. Someone three months from now will find it at 1 a.m. and be grateful to a stranger. Be that stranger.
The point was never the parts. It was a different relationship with a machine — one that waits for you instead of pulling at you. Set your deck up to be calm by default, and it becomes the device you reach for to think, not the one that thinks at you.
Make the default state airplane-mode-with-intent: local files, local notes, a local model. Connect when you choose to, not because something wanted your attention.
A deck with no infinite scroll is a quiet room. Keep the addictive surfaces off it entirely. Let this be the machine that's boring in the best way.
Same as the deck's own power: it runs down and needs charging. A device you built to respect that is a daily reminder to do the same for yourself.
It will never be finished — there's always another HAT, another mod. That's fine. Use it. A working deck in your bag beats a perfect one on the bench.
A glowing screen is a poor workbench companion. Both manuals are offline PDFs, built to print, fold, and live next to the soldering iron.
This whole guide, set for paper — the parts list, the eight assembly steps, and every command in one offline reference you can take off-grid.
Download Field ManualThe drawings — enclosure blueprints, the Pi mounting pattern, port maps and wiring, dimensioned to print and pin above the bench.
Download Blueprint ManualSketch the shape this weekend, order one part, and start. The deck you'll actually carry is the one you began.