Skip to content

ConsolePi Build Guide

Personal project β€” not Cisco-official

This build guide is a home lab recipe layered on top of the open-source ConsolePi project by Wade Wells. Built by a Cisco employee on their own time using publicly documented console interfaces. Not affiliated with, endorsed by, sponsored by, or representing Cisco Systems, Inc.

A tested, opinionated recipe for turning a Raspberry Pi into a network-accessible serial console server, running ConsolePi on Raspberry Pi OS 13 (Trixie).

ConsolePi + Cisco 1210CE topology

What you'll end up with

A quiet, low-power box that:

  • Presents attached serial adapters as telnet ports over your LAN
  • Serves both traditional RJ45 console (via USBβ†’serial adapters) and modern USB-C console ports (native CDC-ACM) that ship on newer Cisco gear (1200/3100/4200 Secure Firewalls, Catalyst 9000 switches)
  • Auto-advertises via mDNS as consolepi.local
  • Runs consolepi-menu for a friendly per-adapter session picker
  • Costs about $85 in parts

Pair it with a smart plug on the target device's power feed and you have "poor man's Opengear" β€” remote console and remote power cycle for any device in your rack, at a fraction of the cost of enterprise console servers.

Who this is for

  • Network engineers, SEs, and lab operators who want an inexpensive OOB management server
  • Anyone standing up modern Cisco firewalls (1200/3100/4200 series) or switches with USB-C console who needs a stable console access path
  • Homelab operators who don't want to keep a laptop plugged into a rack

What this is NOT

  • Not a replacement for enterprise console servers if you need serial concentration for 32+ ports, redundant power supplies, or vendor support
  • Not a security-hardened production management appliance out of the box β€” the defaults are lab-friendly; harden for production use
  • Not a full rewrite of the upstream ConsolePi docs β€” this guide focuses on the specific things that trip people up on Trixie and with USB-C consoles

Time budget

Phase Time
Flash SD card 5 min (Raspberry Pi Imager)
First boot + network up 3 min
SSH in, initial hardening 5 min
Install ConsolePi (silent) ~10 min
Verify + first console session 5 min
Total ~30 min hands-on, ~45 min elapsed

Start here

Head to Bill of Materials for the parts list, then walk the guide top-to-bottom.

If you already have a ConsolePi running and just want to connect it to a USB-C console port on a Cisco 1200/3100/4200 or Catalyst 9000, jump to Connect via USB-C.

If something isn't working, Troubleshooting is organized by symptom.

Acknowledgments

This guide stands on the shoulders of the excellent ConsolePi project by Wade Wells (Pack3tL0ss). All the heavy lifting β€” the installer, ser2net orchestration, mDNS auto-discovery, consolepi-menu, the REST API β€” is his work.

This guide is a build recipe layered on top of ConsolePi, focused on:

  • What actually works on Raspberry Pi OS 13 (Trixie)
  • USB-C console connections to modern Cisco gear
  • Silent-install flags for reproducibility

If you find ConsolePi useful, star the upstream repo and consider contributing to it directly β€” that's where the core work lives.