Running Horizon with Docker on Apple Silicon (ARM)

We provide Horizon container images for the ARM architecture on Docker Hub for our Horizon bleeding image. In case you don’t have a Docker environment set up on your Mac you can set it up with the following instructions.

:biohazard: If you run Horizon on the emulated x86 architecture, you might see JVM crashes during startup. You need to run the bleeding image which will become Horizon 31 at some time in the future.

We have a community repository with pre-configured docker-compose stacks in the GitHub repository stack-play. To spin up a minimal Horizon environment follow these steps.

:warning: The docker-compose stacks are good for playing or testing things. It’s not meant to be for production workloads.

Step 1: Clone the repository with

git clone https://github.com/opennms-forge/stack-play.git

Change the directory with cd stack-play/minimal-horizon. The default image tag is bleeding.

Step 2: Pull the images and start the stack

docker-compose up -d

The configuration files are persisted in a container volume and are not available on the hosts’ file system. To edit the configuration files through the web user interface, you have to add the role ROLE_FILESYSTEM_EDITOR which is not assigned by default.

To apply the changes you have to logout and login again and you can access the File Editor in the Preview UI.

This way you should be able to customize your config files without dealing with mounting the etc-volume in a container and editing it through the command line.


:woman_facepalming: You can fix me, I’m a wiki post.