Wake on LAN Web Interface – Full Setup Guide

Requirements

Debian-based Linux system or Raspberry Pi
Git
Node.js (LTS)

1. Install Git and Node.js (Debian / Raspberry Pi)

# Update package index
sudo apt update

# Install Git and curl
sudo apt install git curl -y

# Install Node.js (LTS version)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Verify installation:

node -v
npm -v
git --version

2. Clone the Repository

git clone https://git.luisk.de/luis/wol-server.git
cd wol-server

3. Edit the HTML File and package.json

Open index.html and modify the marked lines:

nano index.html

Look for comments like:

<!-- CHANGE THIS -->

Adjust the MAC addresses, hostnames, etc.

Also change in package.json the port in scripts: server

4. Install Dependencies

npm install

5. Start the Server Manually (For Testing)

npm run server

You can now access the interface via your browser on your specified port (e.g., http://<your-server-ip>:3000).

6. Auto-Start with systemd (Linux)

To automatically run the server at boot, create a systemd service.

a) Create the Service File

sudo nano /etc/systemd/system/wol-server.service

Paste the following:

[Unit]
Description=Wake on LAN Web Interface
After=network.target

[Service]
WorkingDirectory=/home/pi/wol-server
ExecStart=/usr/bin/npm run server
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

🔧 Replace:

/home/pi/wol-server with the actual path to your project

User=pi with your actual system username

b) Enable and Start the Service

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl enable wol-server
sudo systemctl start wol-server

c) Check Service Status

sudo systemctl status wol-server

You should see:

Active: active (running)

✅ Done! Your Wake on LAN Web Interface is now installed and set to run automatically on system startup.

2.1 KiB Raw Permalink Blame History Unescape Escape