Running Structurizr Lite Docker on Mac with Apple Sillicon

[joshyim]

Expected

Running Structurizr docker image using the command provided on doc: https://docs.structurizr.com/lite/quickstart should start docker container as expected.

Actual

When using the command on Mac with Apple Silicon threw following error message.
docker run -it --rm --name [redacted] \n -p 8080:8080 -v $HOME/projects/[redacted]:/usr/local/structurizr structurizr/lite

error message

#
# A fatal error has been detected by the Java Runtime Environment:
#
#  SIGILL (0x4) at pc=0x0000ffff9233fc5c, pid=1, tid=7
#
# JRE version:  (21.0.5+11) (build )
# Java VM: OpenJDK 64-Bit Server VM (21.0.5+11-LTS, mixed mode, sharing, tiered, compressed oops, compressed class ptrs, g1 gc, linux-aarch64)
# Problematic frame:
# j  java.lang.System.registerNatives()V+0 [email protected]
#
# No core dump will be written. Core dumps have been disabled. To enable core dumping, try "ulimit -c unlimited" before starting Java again
#
# An error report file with more information is saved as:
# //hs_err_pid1.log
[0.011s][warning][os] Loading hsdis library failed
#
# The crash happened outside the Java Virtual Machine in native code.
# See problematic frame for where to report the bug.
#
[error occurred during error reporting (), id 0x5, SIGTRAP (0x5) at pc=0x0000ffffa6c371ec]

Steps to reproduce

1. pull Structurizr lite from Docker Hub
2. run docker run command on Mac with Apple Silicon

Version/build information

structurizr/lite:latest from Docker Hub
Mac OS Sequoia 15.3

Severity

Minor

Priority

Low (I have no budget and there's no rush, please fix this for free)

More information

Workaround:
After appending --platform linux/amd64 into the Docker Run command, I was able to create and run a docker image successfully.

docker run --platform linux/amd64 -it --rm --name [redacted] -p 8080:8080 -v $HOME/projects/[redacted]:/usr/local/structurizr structurizr/lite

Low cost approach may be updating doc to include this variant as an interim workaround.