1) Install Java
Unimus is written in Java, and requires a JRE (Java Runtime Environment) to run.
How to install Java depends on your particular OS / distro.
However, please ensure you install Java 8 or 11 for Unimus version 2.5.0 or older. Java 17 is also supported starting from version 2.5.1 (as mentioned above, JRE is sufficient, Unimus does not need the JDK).
2) Download Unimus
Unimus is available in 2 platform-independent versions:
- .jar
- .war
Download link:
https://unimus.net/download.html
.jar
This is a standard Java application package.
You can run it on any OS / distro / architecture that support Java.
This could be considered a portable (standalone) deployment - you simply run Unimus and it will work.
There is nothing to install, Unimus will not install itself as a service, it will only run when you launch it yourself.
.war
This packaging is used for deployments into Java application servers.
We currently support Tomcat and Jetty out of the box, but Unimus should run on any application server.
Since your application server will run as a service, this is the supported way to deploy Unimus as a service in Linux/Unix.
3a) Running Unimus using the .jar
You can run the .jar file directly. Open a terminal, and run:
java -jar unimus.jar
You should see Unimus outputting its startup sequence into the terminal (stdout).
3b) Deploying Unimus using the .war
The deployment process of the .war into your application server will depend on which Java application server you use.
We have a guide to Tomcat deployment available here.
4) Start using Unimus
Unimus should now be running, you can access it using your browser.
(substitute 'localhost' for the address of your Unimus server)
If this is the first time you run Unimus, we recommend checking out the initial configuration guide here.