# BigFred

## Docs

- [BigFred: Browser-Based DCC Throttle for Model Railroads](https://dcc-5ccd5152.mintlify.app/user-guide/introduction.md): BigFred is a browser-based DCC throttle system for model railroads. Open it on any phone, tablet, or desktop — no app installation required.
- [BigFred Quick Start: Log In and Drive Your First Locomotive](https://dcc-5ccd5152.mintlify.app/user-guide/quickstart.md): Log into BigFred, register your first locomotive, and drive it using the web throttle. Complete walkthrough from first login to moving trains.
- [BigFred Core Concepts: Layouts, Vehicles, Trains, and More](https://dcc-5ccd5152.mintlify.app/user-guide/concepts.md): Understand layouts, vehicles, trains, command stations, interlockings, leases, and user roles in BigFred — everything you need before your first session.
- [Driving Your Locomotives with the BigFred Throttle](https://dcc-5ccd5152.mintlify.app/user-guide/throttle/driving.md): Use the BigFred throttle UI to control locomotive speed and direction, trigger emergency stops, and switch between vehicles and command stations.
- [Controlling BigFred with a Gamepad or USB Controller](https://dcc-5ccd5152.mintlify.app/user-guide/throttle/gamepad.md): Connect a USB or Bluetooth gamepad to your device and map its axes and buttons to throttle speed, direction, emergency stop, and locomotive functions.
- [Configuring and Using Locomotive Functions in BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/throttle/functions.md): Assign labels and icons to DCC functions F0–F28, trigger them from the throttle UI, and configure per-vehicle function sets from the My Vehicles page.
- [Set Up and Manage Your DCC Vehicle Roster in BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/roster/vehicles.md): Add, edit, and organise your DCC locomotives in BigFred. Set short or long addresses, configure decoder functions, and place vehicles on the active layout.
- [Build and Drive Multi-Locomotive Consists in BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/roster/trains.md): Group multiple vehicles into a train consist, set per-member speed multipliers, and drive the whole formation as one unit from the BigFred throttle.
- [Granting Temporary Drive Rights with BigFred Leases](https://dcc-5ccd5152.mintlify.app/user-guide/roster/leases.md): Lend control of your vehicle or train to another BigFred user with the lease system. Set an expiry time and optional speed limit, then reclaim at any time.
- [Using Interlockings to Coordinate at Busy Track Sections](https://dcc-5ccd5152.mintlify.app/user-guide/interlockings/overview.md): Occupy a BigFred interlocking to coordinate with drivers, use radio chat, play station announcements, and manage movements through busy junctions safely.
- [Signalman Role: Managing Interlocking Sessions in BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/interlockings/signalman.md): The signalman controls train movements through a BigFred interlocking. Learn how to claim the role, supervise drivers, and perform throttle takeovers.
- [Using Z21 Handsets and WiThrottle Apps with BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/remotes/overview.md): BigFred supports physical Z21 handsets and WiThrottle apps, pairing them to roster vehicles so you can drive with familiar hardware on your layout.
- [Pairing a Roco Z21 Multi-Mouse or WLANmaus with BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/remotes/z21.md): Connect a Roco Z21 multi-mouse, WLANmaus, or compatible Z21 UDP handset to BigFred over UDP and pair it with a vehicle in your roster.
- [Pairing a WiThrottle or Engine Driver App with BigFred](https://dcc-5ccd5152.mintlify.app/user-guide/remotes/withrottle.md): Connect WiThrottle, Engine Driver, or any WiThrottle-compatible app to BigFred over TCP and pair it to vehicles in your BigFred roster.
- [Install and Run BigFred loco-server on Your Layout](https://dcc-5ccd5152.mintlify.app/admin-guide/installation.md): Download and run the loco-server binary to install BigFred on a Raspberry Pi, NAS, or any Linux/macOS machine on your layout network.
- [Configuring BigFred with the loco-server.conf File](https://dcc-5ccd5152.mintlify.app/admin-guide/configuration.md): Set BigFred's HTTP address, JWT secret, Redis settings, log level, and more using the loco-server.conf file or command-line flags.
- [BigFred Admin: First Login and Initial Setup Steps](https://dcc-5ccd5152.mintlify.app/admin-guide/first-login.md): Complete first-boot setup: change the default admin PIN, create your layout, add a command station, create user accounts, and assign DCC address pools.
- [Managing User Accounts in the BigFred Admin Console](https://dcc-5ccd5152.mintlify.app/admin-guide/users.md): Create, edit, and deactivate BigFred user accounts. Assign roles, set numeric PINs, and configure DCC address pools for each operator.
- [Creating and Managing BigFred Layouts and Sessions](https://dcc-5ccd5152.mintlify.app/admin-guide/layouts.md): Create and manage BigFred layouts. Assign command stations and interlockings, set per-user vehicle caps, and lock layouts between sessions.
- [Adding and Configuring DCC Command Stations in BigFred](https://dcc-5ccd5152.mintlify.app/admin-guide/command-stations.md): Connect BigFred to a Z21, LocoNet serial, or LocoNet TCP command station. Set the connection URI, speed steps, dead-man timing, and handset servers.
- [loco CLI: DCC Decoder Programming and Control Tool](https://dcc-5ccd5152.mintlify.app/admin-guide/cli/loco.md): Use the loco CLI to read and write CVs, program addresses, adjust volume and brightness, control functions, and reset decoders — all from a terminal.
- [loco-server CLI: BigFred Backend Command Reference](https://dcc-5ccd5152.mintlify.app/admin-guide/cli/loco-server.md): Reference for the loco-server command that starts the BigFred backend. Key flags for HTTP address, database path, JWT secret, Redis, and logging.
- [BigFred Diagnostics: Logs, Slots, and the Audit Log](https://dcc-5ccd5152.mintlify.app/admin-guide/diagnostics.md): Access server logs, DCC slot occupancy, and the audit log from the BigFred admin interface to monitor system health and trace operator activity.
- [Troubleshooting BigFred: Fix Common Server Problems](https://dcc-5ccd5152.mintlify.app/admin-guide/troubleshooting.md): Diagnose and fix the most common BigFred problems: connection failures, locomotive not responding, slot exhaustion, session drops, and login issues.