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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions