Skip to content

Proposal: Add idle-less (reverse proxy with Wake-on-LAN) example #683

@tvup

Description

@tvup

Proposal

I'd like to add an example for idle-less — a Docker Compose setup that demonstrates a reverse proxy with automatic Wake-on-LAN for backend servers.

What it does

idle-less is a Docker-based reverse proxy that detects when backend servers are sleeping, sends a Wake-on-LAN magic packet, shows a waiting screen during boot, and forwards traffic when the server is up.

Why it's useful as an awesome-compose example

  • Demonstrates Docker macvlan networking (required for Layer 2 WoL broadcast)
  • Shows multi-service orchestration (nginx proxy + WoL gateway)
  • Practical energy-saving pattern for self-hosted infrastructure
  • Works on Raspberry Pi (ARM64 native)

Proposed compose.yaml

services:
  reverse-proxy:
    image: tvup/idle-less-reverse-proxy:latest
    ports:
      - "80:80"
      - "443:443"
    environment:
      - DOMAIN_1_NAME=app.example.com
      - DOMAIN_1_IP=192.168.1.100
      - DOMAIN_1_CONFIG=wakeforce
    restart: unless-stopped

  wakeforce:
    image: tvup/idle-less-wakeforce:latest
    environment:
      - BACKEND_MAC=AA:BB:CC:DD:EE:FF
      - BACKEND_IP=192.168.1.100
      - LICENSE_KEY=your-license-key
    networks:
      - lanbridge

networks:
  lanbridge:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

Links

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions