tvup/wakeforce repository overview

⁠Wakeforce — Wake-on-LAN Gateway

A Wake-on-LAN gateway that wakes sleeping servers when web traffic arrives. Part of the idle-less⁠ project.

⁠What it does

When your server is sleeping and someone visits your domain:

1. The reverse proxy⁠ detects the backend is down
2. Traffic is redirected to Wakeforce
3. Wakeforce sends a Wake-on-LAN magic packet to boot the server
4. Visitors see a professional waiting screen with real-time health checks
5. Once the server is online, visitors are redirected seamlessly

⁠Quick start

curl -fsSL https://raw.githubusercontent.com/tvup/idle-less/master/install.sh | bash --wakeforce

⁠Requirements

• A valid license key (from €29 — buy here⁠)
• Docker with Compose v2
• A device on the same LAN as target servers (e.g., Raspberry Pi)
• Target servers must support Wake-on-LAN

⁠Architecture

Wakeforce uses macvlan networking to send magic packets directly on the LAN:

┌─────────────────────────────────┐
│  Docker Host                    │
│  ┌──────────┐  ┌────────────┐  │
│  │ reverse-  │  │ wakeforce  │  │
│  │ proxy     │──│ (gateway)  │  │
│  │ :80 :443  │  │ WoL + UI   │  │
│  └──────────┘  └────────────┘  │
│       │ bridge      │ macvlan  │
└───────┼─────────────┼──────────┘
        │             │
   Internet      LAN (WoL packets)

⁠Configuration

The Wakeforce container uses BACKEND_* environment variables internally. When using the installer, these are automatically generated from your DOMAIN_{i}_* configuration.

Variable mapping (installer → container):

⁠Multi-platform

Native images for both architectures:

• linux/amd64 — standard servers
• linux/arm64 — Raspberry Pi, Synology, QNAP

⁠Links

• GitHub⁠
• Website⁠
• Reverse proxy image⁠
• Pricing & licenses⁠

Built by Torben IT ApS⁠ · Get a license⁠