github-starred/awesome-compose
2
0
Fork 0
mirror of https://github.com/docker/awesome-compose.git synced 2026-03-09 06:52:08 -05:00
Code Issues 627 Packages Projects Releases Wiki Activity

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

New Issue
Open
opened 2026-03-07 21:22:48 -06:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-03-07 21:22:48 -06:00
Owner
Copy Link

Originally created by @tvup on GitHub (Mar 2, 2026).

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

Originally created by @tvup on GitHub (Mar 2, 2026). ## 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 ```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 - GitHub: https://github.com/tvup/idle-less - Docker Hub: [tvup/idle-less-reverse-proxy](https://hub.docker.com/r/tvup/idle-less-reverse-proxy), [tvup/idle-less-wakeforce](https://hub.docker.com/r/tvup/idle-less-wakeforce) - Demo: https://tvup.github.io/idle-less/demo.html
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
good first issue
proposal
pull-request
Mirrored from GitHub Pull Request
 question
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/awesome-compose#736
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?