🖥️ Start VMs and LXCs · HTTP & WebSocket API · Multi-Platform

WoL VE is a lightweight Go program exposing an HTTP and WebSocket API for starting virtual environments such as virtual machines and LXC containers.

Use standalone or together with
WoL-Redirect for a web-based UI.

Download the latest binary from the Releases page, mark it executable, and run:

chmod +x wol-ve
./wol-ve

Start a VM or LXC instance by sending a POST request to /wake.
Example: start an instance with ID 100:

curl -X POST "http://wol-ve:9999/wake" \
     -H "Content-Type: application/json" \
     -d '{
           "id": "100",
           "ip": "192.168.1.1",
           "startupTime": 5
         }'

The /wake endpoint returns a client_id.
Use it to open a WebSocket connection:

ws://wol-ve:9999/ws

The WebSocket sends structured updates during the startup sequence:

• success: true when the process completes
• error: true if startup fails
• message: descriptive status or error details

Interval in seconds for pinging when startupTime is not provided.

Number of retries for pinging when startupTime is not provided before timing out.

Have suggestions or improvements? Feel free to open an issue or submit a Pull Request.

This project is licensed under the MIT License.