Server dashboard
Go to file
Antony Leons 73865f6c34 fix docker build 2023-09-14 18:45:52 +01:00
.github Bump docker/setup-buildx-action from 2 to 3 (#81) 2023-09-14 18:14:04 +01:00
.run downgrade OSHI due to error 500 (#21) 2022-04-23 16:58:45 +01:00
images Merge branch 'master' 2022-04-21 17:26:43 +01:00
src/main add port number validation 2023-09-14 18:34:31 +01:00
.gitignore Env setup creation (#5) 2022-03-20 15:49:08 +00:00
Dockerfile fix docker build 2023-09-14 18:45:52 +01:00
LICENSE Merge branch 'master' 2022-04-21 17:26:43 +01:00
README.md Update README.md 2023-01-26 17:50:24 +00:00
docker-compose.yml add docker-compose 2022-03-20 18:10:44 +00:00
pom.xml bump spring boot starter to 3.1.3 2023-09-14 18:25:36 +01:00

README.md

GitHub Workflow Status Docker Pulls

Logo


Demo

Quick start

Docker

  • docker run --restart unless-stopped -it -d --name ward -p 4000:4000 -e WARD_PORT=4000 -e WARD_THEME=dark --privileged antonyleons/ward
  • Go to localhost:4000 in web browser

Also see the example docker-compose.yml file in the root directory.

Java

Download the latest release from here

java -jar ward.jar

About

Ward is a simple and minimalistic server monitoring tool. Ward supports adaptive design system. Also, it supports dark theme. It shows only principal information and can be used, if you want to see nice looking dashboard instead looking on bunch of numbers and graphs. Ward works nice on all popular operating systems, because it uses OSHI.

All features tested on: Windows Linux

Preview Image

Preview Image


Installation

Create your own jar

• Clone the project
• Import project in your IDE as Maven project
• mvn clean package

Run jar file

1. Create you own jar as described above
2. Execute jar on Windows or Linux with administrative rights
3. Enter localhost:4000 and set up application

Build for Docker

1. Clone the project
2. docker build --tag ward
3. docker run --restart unless-stopped -it -d --name ward  -p 4000:4000 -e WARD_PORT=4000 -e WARD_THEME=dark --privileged ward
4. Go to localhost:4000 in web browser

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.

Setting Description Default
serverName Name shown in the interface. Ward
theme Either light or dark. light
port Port to listen on. 4000

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