A minimal Wake-on-LAN server with a web interface. This project is intended to be a simple and intuitive interface for users to wake up their devices remotely over the same network.

You can deploy this project on a Raspberry Pi or any other device that supports Node.js or Docker.

# Install dependencies
npm install

# Set up the environment variables (.env file)
npm run setup

# Start the server
npm run start

Access the web interface at:
👉 http://localhost:3000

# Install pm2 globally
npm install -g pm2

# Start the server with pm2
pm2 start app.js --name wolite

Access the web interface at:
👉 http://localhost:3000

Create an empty data directory at the current directory:

mkdir data

Deploy with docker command:

docker run -d -p 3000:3000 \
  -e USERNAME="your-username" \
  -e PASSWORD="your-password" \
  -e ALLOWED_IPS="ALL" \ # optional
  -e ENABLE_OTP=false \ # optional
  -v /full/path/to/data:/usr/wolite/data \ # optional
  --name wolite
  sean1832/wolite:latest

For more information, see Docker Deployment Guide.

Create an empty data folder at the current directory where the docker-compose.yml file is located.

mkdir data
touch docker-compose.yaml

Copy and paste the following to docker-compose.yaml

version: "3"
services:
  wolite:
    image: sean1832/wolite:latest
    container_name: wolite
    ports:
      - "3000:3000"
    environment:
      - USERNAME=your-username # required
      - PASSWORD=your-password # required

      # # (Optional) Uncomment to enable
      # - ENABLE_OTP=true
      # - ALLOWED_ORIGINS="ALL" # `ALL` to allow all ip. Add specific ip addresses to restrict access
      # - PORT=3000
    volumes:
      - ./data:/usr/wolite/data

Run the following command to deploy WOLITE with Docker Compose:

docker-compose up -d

For more information, see Docker Compose Deployment Guide.