antonyleons/ward-rs repository overview

⁠Demo

https://status.leons.dev⁠

⁠Preview

https://raw.githubusercontent.com/AntonyLeons/ward-rs/main/images/preview.png⁠

⁠Quick start

⁠Docker

docker run --restart unless-stopped -it -d --name ward -p 4000:4000 -e WARD_PORT=4000 -e WARD_THEME=dark --cap-add SYS_PTRACE -v /:/host:ro antonyleons/ward

Go to http://localhost:4000⁠

⁠Docker compose

version: '3.3'
services:
  run:
    restart: unless-stopped
    container_name: ward
    ports:
      - '4000:4000'
    environment:
      - WARD_PORT=4000
      - WARD_THEME=light
      - WARD_NAME=Ward
      - WARD_FOG=true
      - WARD_BACKGROUND=#3c3c3c
    cap_add:
      - SYS_PTRACE
    volumes:
      - /:/host:ro
    image: antonyleons/ward

⁠Config

If you want to change Ward's configuration, you can edit setup.ini. When using Docker, use the environment variables WARD_NAME,WARD_THEME, WARD_PORT to automatically regenerate this file at startup. Using any environment variable listed will enable the defaults below and immediately start Ward without the GUI setup.

Environment variables take priority and will regenerate this file with your variables. If no environment variables are set, setup.ini is generated once you navigate to Ward's webpage and complete the initial setup. You can also make this file yourself before starting Ward, and place it in the same directory.

For example:

[setup]
serverName = my-server
theme = dark
port = 8200
enableFog = true
backgroundColor = #303030

⁠Performance (Rust rewrite)

• Memory Footprint: ~5MB to 8MB RAM (≈16–38× less than legacy Java)
• Startup Speed: < 10ms (≈150–250× faster than legacy Java)
• Application Size: ~6MB to 8MB binary (≈6–8× smaller than legacy ward.jar)
• Idle CPU: ~0% (no garbage collection overhead)

⁠About

Ward is a simple and minimalistic server monitoring tool. Ward supports an adaptive design system and a dark theme. It shows only principal information and can be used if you want a nice looking dashboard instead of a bunch of numbers and graphs. Ward works nice on all popular operating systems, because it uses https://github.com/GuillaumeGomez/sysinfo⁠.

⁠Older builds have been removed in the interest of security, all configs should be backwards compatible.

⁠Legacy Java

https://github.com/AntonyLeons/Ward⁠