🧙‍♂️ LANdalf

"You Shall Not Sleep!"

A Modern Wake-on-LAN Management Platform

Features • Quick Start • Docs • Contributing

---

📖 About

LANdalf is a web-based Wake-on-LAN management platform built with .NET 10.0, Blazor WebAssembly, and MudBlazor. It lets you manage network devices and wake them remotely — deployable in seconds via Docker Compose.

✨ Features

• Device Management — Add, edit, and organize network devices with MAC address storage
• Wake-on-LAN — Send magic packets to wake sleeping devices remotely
• RESTful API — Versioned API with OpenAPI documentation (API Guide)
• Docker Ready — One-command deployment, cross-platform (Windows, Linux, macOS)

Interface Preview

🚀 Quick Start

Create a docker-compose.yaml:

services:
  api:
    image: ghcr.io/renedierking/landalf-api:latest
    container_name: landalf-api
    network_mode: host
    environment:
      - ASPNETCORE_URLS=http://+:5000
      - Cors__FrontendUrl=http://localhost # Adjust if NGINX_PORT != 80, e.g. http://localhost:8080
      # Docker Desktop (Windows/macOS): Uncomment and set your LAN broadcast for WoL to work.
      # - WOL_BROADCASTS=192.168.178.255
      - Serilog__MinimumLevel__Default=Information
      - Serilog__MinimumLevel__Override__Microsoft.AspNetCore=Warning
      - Serilog__MinimumLevel__Override__Microsoft.EntityFrameworkCore=Warning
    volumes:
      - api-data:/app/LANdalf_Data
      - api-logs:/app/logs
    restart: unless-stopped

  ui:
    image: ghcr.io/renedierking/landalf-ui:latest
    container_name: landalf-ui
    network_mode: host
    environment:
      - NGINX_PORT=80 # Change to any free port, then update Cors__FrontendUrl above
    depends_on:
      - api
    restart: unless-stopped
volumes:
  api-data:
  api-logs:

docker compose up -d

• UI: http://localhost
• API: http://localhost:5000
• API Docs: http://localhost:5000/scalar/v1

Custom UI port: Set NGINX_PORT (e.g. 8080) and update Cors__FrontendUrl accordingly (e.g. http://localhost:8080).

Docker Desktop (Windows/macOS): WoL magic packets won't reach your LAN by default. Uncomment WOL_BROADCASTS in the compose file and set it to your LAN broadcast address (e.g. 192.168.178.255). See the WoL Setup Guide for details.

For manual setup, platform-specific instructions, and troubleshooting, see the Installation Guide.

📚 Documentation

Guide	Description
🚀 Installation & Setup	Docker & manual installation, configuration, troubleshooting
🔧 Wake-on-LAN Setup	Device configuration, network setup, testing WoL
📡 API Usage Guide	API reference, examples, error handling
🏗️ Architecture	System design, tech stack, data flow, database schema
🗺️ Roadmap	Planned features and enhancements

🛠️ Development

dotnet build LANdalf.slnx   # Build
dotnet test                  # Test
docker compose build         # Docker images

See CONTRIBUTING.md for prerequisites, project structure, and development guidelines.

🤝 Contributing

Contributions are welcome! Please read the Contributing Guide for the workflow and guidelines.

📄 License

MIT — see LICENSE for details.

📞 Support

• GitHub Issues · GitHub Discussions

---

Made with ❤️ by renedierking

If you find LANdalf helpful, please consider giving it a ⭐!