Install and Run BigFred loco-server on Your Layout

Download and run the loco-server binary to install BigFred on a Raspberry Pi, NAS, or any Linux/macOS machine on your layout network.

BigFred runs as a single self-contained binary called loco-server. It bundles everything your layout needs in one process: the HTTP API, the embedded web frontend, DCC bus daemon management, and a Valkey (Redis-compatible) sidecar for real-time state. There is nothing extra to install alongside it — drop the binary on any Linux or macOS machine, run it, and open a browser.

System Requirements

Operating System

Linux (x86-64 or ARM) or macOS. A Raspberry Pi 4 or newer works well for a dedicated layout server.

Network

The server must be reachable by the devices your operators use and must have network access to your DCC command station.

Client

Any modern browser on the same network — desktop, tablet, or phone.

Installation Steps

Raspberry Pi Tips

Assign your Raspberry Pi a static IP address on your layout network and note it in your layout documentation. Your operators need to know where to point their browsers, and the address should never change between operating sessions. Most home routers let you assign a static DHCP lease by MAC address — no changes needed on the Pi itself.

Once installed, continue with Configuring BigFred to set a persistent JWT secret and tune other options, then complete the First Login setup steps.