Files

Benson Wong d18dc26d01 cmd/wol-proxy: tweak logs to show what is causing wake ups (#356 )

fix the extra wake ups being caused by wol-proxy

* cmd/wol-proxy: tweak logs to show what is causing wake ups
* cmd/wol-proxy: add skip wakeup
* cmd/wol-proxy: replace ticker with SSE connection
* cmd/wol-proxy: increase scanner buffer size
* cmd/wol-proxy: improve failure tracking

2025-10-25 11:04:31 -07:00

README.md

cmd/wol-proxy: add wol-proxy (#352 )

2025-10-20 20:55:02 -07:00

wol-proxy.go

cmd/wol-proxy: tweak logs to show what is causing wake ups (#356 )

2025-10-25 11:04:31 -07:00

README.md

wol-proxy

wol-proxy automatically wakes up a suspended llama-swap server using Wake-on-LAN when requests are received.

When a request arrives and llama-swap is unavailable, wol-proxy sends a WOL packet and holds the request until the server becomes available. If the server doesn't respond within the timeout period (default: 60 seconds), the request is dropped.

This utility helps conserve energy by allowing GPU-heavy servers to remain suspended when idle, as they can consume hundreds of watts even when not actively processing requests.

Usage

# minimal
$ ./wol-proxy -mac BA:DC:0F:FE:E0:00 -upstream http://192.168.1.13:8080

# everything
$ ./wol-proxy -mac BA:DC:0F:FE:E0:00 -upstream http://192.168.1.13:8080 \
    # use debug log level
    -log debug \
    # altenerative listening port
    -listen localhost:9999 \
    # seconds to hold requests waiting for upstream to be ready
    -timeout 30

API

GET /status - that's it. Everything else is proxied to the upstream server.