Run with the JAR

Alginte also ships as a single fat JAR — the backend and the web UI in one file. It requires a Java 25 runtime.

java -jar alginte.jar --spring.kafka.bootstrap-servers=<kafka-host>:9092

Then open http://localhost:8888.

The bind-address boundary

By default server.address=localhost, so a plain java -jar serves only the local machine. Overriding the bind address is the moment you take ownership of the security boundary — anyone who can reach the port has full control of every connected Kafka cluster unless you enable the login.

To serve a trusted network, override the bind and put a reverse proxy (TLS termination, network allow-listing) in front:

java -jar alginte.jar \
  --server.address=0.0.0.0 \
  --spring.kafka.bootstrap-servers=<kafka-host>:9092

Or via the environment:

SERVER_ADDRESS=0.0.0.0 \
SPRING_KAFKA_BOOTSTRAPSERVERS=<kafka-host>:9092 \
java -jar alginte.jar

Configuration

Everything configurable via application.properties can be set on the command line (--property=value) or through environment variables (Spring relaxed binding). See Configuration for the properties that matter, and mount an external file with --spring.config.additional-location= if you prefer a file over flags.

Docker Configuration

​The bind-address boundary

​Configuration

The bind-address boundary

Configuration