// Open Source · Self-Hosted

LAN PARTY
MANAGER

A self-hosted web app for organizing your LAN party weekends. Crew management, expenses, tournaments, and more — all from any phone or laptop on your network.

Get on GitHub Explore Features →
localhost:3001 — HUB
HUB PLAYER LAN PARTY TREASURY ARENA
8
Players
€ 420
Budget
3
Tournaments
2
Upcoming
CW
CrossWax
ADMIN
ZR
ZeroRush
READY
PX
Phx_GG
USER
N7
NightBot7
READY

// Features

EVERYTHING FOR A
PERFECT LAN

One app your whole crew uses from their phones and laptops. No cloud, no subscription — just run it on any machine or Raspberry Pi.

Crew Management
Invite-only registration via single-use links. Player profiles with avatar, arrival/departure dates, t-shirt size, and volunteer roles.
LAN Party Calendar
Schedule upcoming LAN events with start/end dates, location, and description. Upcoming events are highlighted; past events archived automatically.
Treasury & Pro-Rata
Treasurer logs expenses by category. Costs split automatically based on each player's attendance nights — pay only for the days you were there.
Team & Solo Tournaments
Create bracket tournaments for team games (CS, Rocket League) or solo/individual events (Smash Bros, FFA). Auto-advancement on score entry.
Invite-Only Access
First user becomes admin automatically. All subsequent registrations require a valid invite token — single-use, expiring, admin-revokable.
Docker · Raspberry Pi
One command deploy. Runs on any machine or Raspberry Pi 4/5 (ARM64). SQLite database — zero external dependencies, data stays on your machine.

// LAN PARTY

PLAN YOUR LANS,
KEEP THE CREW
IN SYNC

Schedule your LAN party dates well in advance. Every player in the crew can see what's coming and plan their availability.

  • Upcoming events highlighted with accent styling
  • Start date, end date, location, and description
  • Past events automatically archived below
  • Admin-only create / edit / delete controls
localhost:3001/events
HUB PLAYER LAN PARTY TREASURY ARENA

UPCOMING — 2 EVENTS

LAN Party #6 — Summer Edition
UPCOMING
14 Jul 2026 → 17 Jul 2026 4 DAYS
📍 42 Gaming St, Lyon
Halloween LAN 2026
UPCOMING
30 Oct 2026 → 01 Nov 2026 3 DAYS

PAST — 1 EVENT

LAN Party #5 — Spring
PAST
03 Jun 2026 → 05 Jun 2026 3 DAYS

// Arena

TEAM OR SOLO
TOURNAMENT
BRACKETS

Run tournaments for any game. Team events for CS, Rocket League, or LoL. Individual events for Smash Bros, Tekken, or any FFA game.

  • Choose TEAM or INDIVIDUAL when creating a tournament
  • Auto-generated brackets with shuffled seeding
  • Byes handled automatically for odd team counts
  • Live score entry — winner auto-advances to the next round
  • Supports up to Round of 16 (16 entries)
localhost:3001/tournaments
HUB PLAYER LAN PARTY TREASURY ARENA

BRACKET — SUPER SMASH BROS ULTIMATE

Semifinal

CrossWax
3
NightBot7
1
ZeroRush
3
Phx_GG
2

Final

CrossWax
—
ZeroRush
—
SOLO SINGLE ELIMINATION IN PROGRESS

// Treasury

SPLIT COSTS
BASED ON WHO
WAS THERE

The Treasurer logs shared expenses. The pro-rata algorithm automatically calculates each player's fair share based on how many nights they attended.

  • Expenses by category: food, drinks, equipment, accommodation…
  • Pro-rata: cost ÷ person-nights × your nights = your share
  • Players who arrive late or leave early pay less, automatically
  • Players without dates set are excluded from the split
localhost:3001/finances — Pro-Rata
HUB PLAYER LAN PARTY TREASURY ARENA
€ 420
Total
3
Nights
9
Person-nights
Player Nights Share
CrossWax
 4 nights € 186.67
ZeroRush
 3 nights € 140.00
Phx_GG
 2 nights € 93.33

// Deploy

UP AND RUNNING
IN 3 COMMANDS

No cloud account. No subscription. No database server. Everything runs in Docker — on your laptop, a spare PC, or a Raspberry Pi on your local network.

// STEP 01
Clone the repo
git clone
github.com/ChrisBoardoo/
LanPartyManager

cd LanPartyManager
// STEP 02
Set your secret key
# copy the example env file
cp .env.example .env

# edit SECRET_KEY to a long
# random string
nano .env
// STEP 03
Launch
docker compose up --build

# Frontend → :3001
# API → :8000
# API docs → :8000/docs

// Tech Stack

BUILT WITH THE
RIGHT TOOLS

FastAPI
Python 3.11 · Backend API
React 18
TypeScript · Frontend
SQLite
Via SQLAlchemy · Database
Docker
Compose · Deployment
Tailwind CSS
Utility-first · Styling
JWT + bcrypt
python-jose · Auth
Nginx
Alpine · Frontend serving
Vite 5
Build tool · Dev server

// Open Source · Free Forever

READY TO HOST
YOUR LAN?

Grab the code on GitHub, deploy in minutes, and let your crew focus on gaming — not spreadsheets.

View on GitHub Watch on Twitch