Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

To run Unimus in Docker, you have 2 options:

  1. Use a pre-built Unimus Docker image
  2. Build your own Unimus Docker image

1) Using a pre-built Docker image

You can use an image We recommend using a Docker image from:
https://githubhub.docker.com/crocandrr/docker-croc/unimus

Please see the instructions available on the GitHub page for more info.

2) Building your own Docker image

Docker introduction

You'll need to have the Docker tools installed, which you can get from :
https://wwwgithub.docker.com/products/docker.
We tested using Docker for Windows, but it shouldn't make any difference which platform you're on.

If you're not familiar with Docker, you can read more about it at Docker.com.

How to build a Docker image

Text in bold denotes commands to be run at the prompt.
Text in italic denotes directory and/or file names.

  • Open a Command Prompt, or console and create a working directory (mkdir unimus), then change into that directory (cd unimus).
  • Create a sub-directory called content (mkdir content), and download a copy of Unimus.jar into the content directory.
  • In the working folder, create a file called Dockerfile, with the following contents:
Code Block
FROM java:8
ADD content /usr/src/app
WORKDIR /usr/src/app
ENTRYPOINT ["java", "-jar", "./Unimus.jar"]
EXPOSE 8085
  • Run "docker build -t unimus ." to build an image called unimus from the current directory
  • You can now run the image with the command docker run -P 8085:8085 unimus
  • You should be able to access the Unimus UI by navigating to http://localhost:8085 in your web browser

Tips

You can push the image to a local instance of Docker Registry if you need to run it on another machine.

We recommend using a separate database, rather than the file-based HSQL option.
This will allow you to update Unimus easily without losing any data.

crocandr/docker-unimus

How to access Unimus

Unimus should now be running at http://localhost:8085, and you can access it using your browser.
(substitute 'localhost' for the address of your Docker host if needed)

If this is the first time you run Unimus, we recommend checking out the initial configuration guide here.

Credit

All credit for this guide goes to X-Cubed, here is the original forum topic:
https://forum.unimus.net/viewtopic.php?f=4&t=39