Skip to content
Heracles LDMT Heracles Linux Deployment Maintenance Tools
Get started

Get started

One Linux host (x86_64 or ARM64), one free port, one browser. No JDK, no database, no client to install.

1

Unzip

unzip heracles-ldmt-*-demo.zip. Inside are the jar, the startup script and a jre directory — nothing else to fetch.

2

Run ./startup.sh

It unpacks the bundled JRE for this architecture and starts in the background on port 8766; add --server.port=8080 to change it.

3

Sign in, change the password

Open http://<server-ip>:8766/. First login is admin / admin — change it immediately.

Requirements

ItemRequirement
RuntimeNo JDK required: a JRE 8 ships inside the package (x86_64 and aarch64), picked automatically by the startup script
Operating systemLinux (x86_64 / ARM64) preferred; Windows uses startup.bat, macOS works too
Memory1 GB minimum, 2 GB recommended
DatabaseSQLite, embedded — nothing to deploy
NetworkNeeds to reach port 22 on managed machines; the product itself needs no internet
Target machinesOnly sshd and a working account — no client, no agent, no Python
Two things before production: (1) supply your own encryption secret via HERACLES_CRYPTO_SECRET instead of the built-in fallback; (2) change the default admin password. The demo package keeps the default key so it starts without setup — that is not a production configuration.

First-run questions

The port is already in use?

Start with --server.port=8080 to pick a free port.

Where is the data stored?

In an SQLite file under the program directory. Backup means copying that one file.

Adding a machine fails to connect?

Try ssh from a shell first: confirm port 22 is reachable and the account works. The product uses the same credentials.

Do I need to install a JDK?

No. The JRE is in the package and the startup script unpacks it, so JAVA_HOME is never involved. Targets need nothing beyond sshd.

Can I change the language?

Yes, there is a switcher in the console. Both Chinese and English packs ship with it.