Skip to content

Home

PowerBeacon banner

Self-Hosted Wake-on-LAN Orchestration Platform

PowerBeacon helps you wake, manage, and monitor machines across distributed networks with a secure backend, a responsive frontend, and a lightweight cross-platform agent.

Clusters group devices and agents, devices can use multiple agents, and wake operations fan out through all associated online relays.

New to PowerBeacon?

Start with Setup Overview or Docker Deployment, then continue with Architecture Overview.

Product Snapshot

graph LR
   A[Frontend\nReact + Vite] -->|REST API| B[Backend\nFastAPI]
   B --> C[(PostgreSQL)]
   B -->|Dispatch WOL| D[Agents\nGo]
   D -->|UDP Broadcast| E[Managed Devices]
   style A fill:#3b82f6,stroke:#1d4ed8,color:#fff
   style B fill:#7c3aed,stroke:#5b21b6,color:#fff
   style C fill:#db2777,stroke:#9d174d,color:#fff
   style D fill:#0ea5e9,stroke:#0369a1,color:#fff
   style E fill:#f59e0b,stroke:#b45309,color:#fff

Start Here

Area What you will find
Setup Local development setup, first run, and environment configuration
Deployment Production deployment patterns and best practices
Architecture How backend, frontend, and agent work together
API Endpoint families, request patterns, and auth expectations
Guides Practical walkthroughs for common tasks
Operations Deployment, monitoring, and production hardening notes
About Team and project context

Quick Start Paths

1
2
cp .env.example .env
docker compose up --build
  • Frontend: http://localhost:3000
  • API docs: http://localhost:8000/api/docs
1
2
3
4
cd backend
python -m venv .venv
# activate + install deps
uvicorn main:app --reload --port 8000

1
2
3
cd frontend
npm install
npm run dev

Platform At A Glance

Core Components

  1. Backend Python service responsible for authentication, device lifecycle, scheduling, and control-plane APIs.
  2. Frontend Web dashboard for operators to discover devices, issue wake actions, and manage environments.
  3. Agent Small Go binary for network-side Wake-on-LAN execution and backend communication.

Why PowerBeacon

  • Centralized Wake-on-LAN orchestration for many devices and sites
  • Pluggable deployment model: local docker-compose and cloud-ready topologies
  • Security-first approach with authenticated control paths
  • Practical observability and operational guidance for production setups

Quick Launch

Follow the path below if you are new to the project:

  1. Read Initial Setup
  2. Run the stack with Docker Compose
  3. Open the frontend and complete first configuration
  4. Register or connect agents
  5. Create a cluster if you want to group devices and relays
  6. Trigger your first device or cluster wake operation

WOL on Docker Desktop

On Windows and macOS, LAN broadcast from containers is unreliable. Use the agent-based dispatch model for production wake reliability.

Documentation Map

  • Setup: Install and run locally, configure dependencies, and validate services.
  • Deployment: Production deployment patterns, security hardening, and operational best practices.
  • Architecture: Understand responsibilities and data flow across components.
  • API: Learn endpoint behavior, contracts, and auth expectations.
  • Guides: Task-focused walkthroughs and troubleshooting playbooks.
  • Operations: Production deployment, monitoring, and maintenance best practices.

Built for operators who want remote power control that is simple to run and reliable at scale.