drache42/wakeonlanservice repository overview

⁠WakeOnLanService

WakeOnLanService is a Flask-based application designed to send Wake-on-LAN (WoL) packets to specified MAC addresses and then redirects to a given URL. This is helpful when a homelab service is only available when a computer is on. The WoL packet will wake up the computer, and the webpage will redirect once the URL is available.

This Docker image allows you to easily deploy the WakeOnLanService application in a containerized environment.

⁠Features

• Wake-on-LAN: Send magic packets to wake up devices on your network.
• Health Check: Built-in health check endpoint to monitor the application's status.
• Environment Variables: Easily configurable via environment variables for MAC address and target URL.
• Dockerized: Simplified deployment using Docker.

⁠GitHub

GitHub repo can be found here⁠. Contributions are welcome!

⁠Usage

1. Pull the Docker image: docker pull drache42/wakeonlanservice:latest

2. Run the Docker container: docker run -it --rm -p 4200:4200 -e URL=your_url_here -e MAC_ADDRESS=your_mac_address_here drache42/wakeonlanservice:latest

Access the application: Open your web browser and navigate to http://localhost:4200⁠.

⁠Environment Variables

• MAC_ADDRESS: The MAC address of the device to wake up.
• URL: The URL to check the status of the device.

⁠Health Check

The application includes a health check endpoint at /healthcheck to verify that the service is running correctly.

⁠License

This project is licensed under the MIT License. See the LICENSE file for details.