Server fails to start

[skyycode-0]

Describe the problem

Using the default docker compose, it fails to start due to a java exception. I have tried the different server variants and all of them stop because of this error. If it helps, I'm running the container on an Orange Pi.

Container definition

services:
  mc:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
    volumes:
      # attach the relative directory 'data' to 
      - ./data:/data

Container logs

mc-1  | [init] Running as uid=1000 gid=1000 with /data as 'drwxr-xr-x 2 1000 1000 4096 May 11 02:06 /data'
mc-1  | [init] Image info: buildtime=2025-05-10T16:25:18.623Z,version=java21,revision=5fe65a68c30b7678381930a3fad798386800df43
mc-1  | [init] Resolving type given VANILLA
mc-1  | Exception in thread "main" java.lang.NoClassDefFoundError: ch/qos/logback/classic/joran/action/ContextNameAction
mc-1  |         at ch.qos.logback.classic.util.DefaultJoranConfigurator.configureByResource(DefaultJoranConfigurator.java:66)
mc-1  |         at ch.qos.logback.classic.util.DefaultJoranConfigurator.configure(DefaultJoranConfigurator.java:35)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.invokeConfigure(ContextInitializer.java:128)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.autoConfig(ContextInitializer.java:103)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.autoConfig(ContextInitializer.java:66)
mc-1  |         at ch.qos.logback.classic.spi.LogbackServiceProvider.initializeLoggerContext(LogbackServiceProvider.java:52)
mc-1  |         at ch.qos.logback.classic.spi.LogbackServiceProvider.initialize(LogbackServiceProvider.java:41)
mc-1  |         at org.slf4j.LoggerFactory.bind(LoggerFactory.java:196)
mc-1  |         at org.slf4j.LoggerFactory.performInitialization(LoggerFactory.java:183)
mc-1  |         at org.slf4j.LoggerFactory.getProvider(LoggerFactory.java:486)
mc-1  |         at org.slf4j.LoggerFactory.getILoggerFactory(LoggerFactory.java:472)
mc-1  |         at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:421)
mc-1  |         at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:447)
mc-1  |         at me.itzg.helpers.McImageHelper.<clinit>(McImageHelper.java:100)
mc-1  | Caused by: java.lang.ClassNotFoundException: ch.qos.logback.classic.joran.action.ContextNameAction
mc-1  |         at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(Unknown Source)
mc-1  |         at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(Unknown Source)
mc-1  |         at java.base/java.lang.ClassLoader.loadClass(Unknown Source)
mc-1  |         ... 14 more

[itzg]

I am not able to recreate this issue, so I suspect it is something about the Orange Pi platform.

Can you set the environment variable DEBUG to "true" and provide those logs?

Can you also provide the output of docker info?

[skyycode-0]

New logs:

mc-1  | + export HOME=/data
mc-1  | + HOME=/data
mc-1  | ++ id -u
mc-1  | ++ id -g
mc-1  | ++ ls -lnd /data
mc-1  | + log 'Running as uid=1000 gid=1000 with /data as '\''drwxr-xr-x 2 1000 1000 4096 May 11 02:06 /data'\'''
mc-1  | + local oldState
mc-1  | ++ shopt -po xtrace
mc-1  | + oldState='set -o xtrace'
mc-1  | + shopt -u -o xtrace
mc-1  | [init] 2025-05-11 03:47:32+00:00 Running as uid=1000 gid=1000 with /data as 'drwxr-xr-x 2 1000 1000 4096 May 11 02:06 /data'
mc-1  | ++ paste -d, -s /etc/image.properties
mc-1  | + log 'Image info: buildtime=2025-05-10T16:25:18.623Z,version=java21,revision=5fe65a68c30b7678381930a3fad798386800df43'
mc-1  | + local oldState
mc-1  | ++ shopt -po xtrace
mc-1  | + oldState='set -o xtrace'
mc-1  | + shopt -u -o xtrace
mc-1  | [init] 2025-05-11 03:47:32+00:00 Image info: buildtime=2025-05-10T16:25:18.623Z,version=java21,revision=5fe65a68c30b7678381930a3fad798386800df43
mc-1  | + '[' '!' -e /data/eula.txt ']'
mc-1  | + isTrue false
mc-1  | + case "${1,,}" in
mc-1  | + return 1
mc-1  | + isTrue true
mc-1  | + case "${1,,}" in
mc-1  | + return 0
mc-1  | + set +x
mc-1  | + isTrue false
mc-1  | + case "${1,,}" in
mc-1  | + return 1
mc-1  | + isTrue false
mc-1  | + case "${1,,}" in
mc-1  | + return 1
mc-1  | + [[ -n '' ]]
mc-1  | + fixJavaPath
mc-1  | + which java
mc-1  | + cd /data
mc-1  | + export DECLARED_TYPE=VANILLA
mc-1  | + DECLARED_TYPE=VANILLA
mc-1  | + export DECLARED_VERSION=LATEST
mc-1  | + DECLARED_VERSION=LATEST
mc-1  | + isTrue false
mc-1  | + case "${1,,}" in
mc-1  | + return 1
mc-1  | + isTrue false
mc-1  | + case "${1,,}" in
mc-1  | + return 1
mc-1  | + [[ -n '' ]]
mc-1  | + [[ -n '' ]]
mc-1  | + [[ -n '' ]]
mc-1  | + [[ -n '' ]]
mc-1  | + [[ -n '' ]]
mc-1  | + : ''
mc-1  | + [[ -n '' ]]
mc-1  | + case "${TYPE^^}" in
mc-1  | + [[ -n '' ]]
mc-1  | + log 'Resolving type given VANILLA'
mc-1  | + local oldState
mc-1  | ++ shopt -po xtrace
mc-1  | + oldState='set -o xtrace'
mc-1  | + shopt -u -o xtrace
mc-1  | [init] 2025-05-11 03:47:32+00:00 Resolving type given VANILLA
mc-1  | + case "${TYPE^^}" in
mc-1  | + exec /start-deployVanilla
mc-1  | + set -o pipefail
mc-1  | + resolveVersion
mc-1  | + givenVersion=LATEST
mc-1  | ++ mc-image-helper resolve-minecraft-version LATEST
mc-1  | Exception in thread "main" java.lang.NoClassDefFoundError: ch/qos/logback/classic/joran/action/ConsolePluginAction
mc-1  |         at ch.qos.logback.classic.util.DefaultJoranConfigurator.configureByResource(DefaultJoranConfigurator.java:66)
mc-1  |         at ch.qos.logback.classic.util.DefaultJoranConfigurator.configure(DefaultJoranConfigurator.java:35)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.invokeConfigure(ContextInitializer.java:128)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.autoConfig(ContextInitializer.java:103)
mc-1  |         at ch.qos.logback.classic.util.ContextInitializer.autoConfig(ContextInitializer.java:66)
mc-1  |         at ch.qos.logback.classic.spi.LogbackServiceProvider.initializeLoggerContext(LogbackServiceProvider.java:52)
mc-1  |         at ch.qos.logback.classic.spi.LogbackServiceProvider.initialize(LogbackServiceProvider.java:41)
mc-1  |         at org.slf4j.LoggerFactory.bind(LoggerFactory.java:196)
mc-1  |         at org.slf4j.LoggerFactory.performInitialization(LoggerFactory.java:183)
mc-1  |         at org.slf4j.LoggerFactory.getProvider(LoggerFactory.java:486)
mc-1  |         at org.slf4j.LoggerFactory.getILoggerFactory(LoggerFactory.java:472)
mc-1  |         at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:421)
mc-1  |         at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:447)
mc-1  |         at me.itzg.helpers.McImageHelper.<clinit>(McImageHelper.java:100)
mc-1  | Caused by: java.lang.ClassNotFoundException: ch.qos.logback.classic.joran.action.ConsolePluginAction
mc-1  |         at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(Unknown Source)
mc-1  |         at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(Unknown Source)
mc-1  |         at java.base/java.lang.ClassLoader.loadClass(Unknown Source)
mc-1  |         ... 14 more
mc-1  | + VERSION=
mc-1  | + exit 2
mc-1 exited with code 2

Docker info:

Client: Docker Engine - Community
 Version:    28.0.2
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.22.0
    Path:     /usr/libexec/docker/cli-plugins/docker-buildx
  compose: Docker Compose (Docker Inc.)
    Version:  v2.34.0
    Path:     /usr/libexec/docker/cli-plugins/docker-compose

Server:
 Containers: 4
  Running: 3
  Paused: 0
  Stopped: 1
 Images: 5
 Server Version: 28.0.2
 Storage Driver: overlay2
  Backing Filesystem: extfs
  Supports d_type: true
  Using metacopy: false
  Native Overlay Diff: true
  userxattr: false
 Logging Driver: json-file
 Cgroup Driver: systemd
 Cgroup Version: 2
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
 Swarm: inactive
 Runtimes: io.containerd.runc.v2 runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: bcc810d6b9066471b0b6fa75f557a15a1cbf31bb
 runc version: v1.2.4-0-g6c52b3f
 init version: de40ad0
 Security Options:
  apparmor
  seccomp
   Profile: builtin
  cgroupns
 Kernel Version: 6.6.75-current-sunxi64
 Operating System: Armbian 25.5.0-trunk.271 bookworm
 OSType: linux
 Architecture: aarch64
 CPUs: 4
 Total Memory: 914.1MiB
 Name: myserver
 ID: a3cb310d-5eb8-49fc-9c6a-c3b2d092a15a
 Docker Root Dir: /var/lib/docker
 Debug Mode: false
 Experimental: false
 Insecure Registries:
  ::1/128
  127.0.0.0/8
 Live Restore Enabled: false

For the most part, I honestly do not understand why java can't seem to find the respective classes. (or something)
I've run the container before and it worked fine.

[itzg]

Thanks. Still quite strange. It's as if the image is somehow corrupted. Before trying some things can you provide the output of:

docker run -it --rm --entrypoint bash itzg/minecraft-server -c 'ls /usr/share/mc-image-helper-*/lib'

After that, the only thing I can think to try is delete the image with

docker image rm itzg/minecraft-server

and re-pull it.

[EvinRobertson]

I have this same ClassNotFoundException on an Odroid N2, also running Armbian.

Client:
Version: 26.1.5+dfsg1
Context: default
Debug Mode: false
Plugins:
compose: Docker Compose (Docker Inc.)
Version: 2.26.1-4
Path: /usr/libexec/docker/cli-plugins/docker-compose

Server:
Containers: 5
Running: 0
Paused: 0
Stopped: 5
Images: 0
Server Version: 26.1.5+dfsg1
Storage Driver: overlay2
Backing Filesystem: extfs
Supports d_type: true
Using metacopy: false
Native Overlay Diff: true
userxattr: false
Logging Driver: json-file
Cgroup Driver: systemd
Cgroup Version: 2
Plugins:
Volume: local
Network: bridge host ipvlan macvlan null overlay
Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
Swarm: inactive
Runtimes: io.containerd.runc.v2 runc
Default Runtime: runc
Init Binary: docker-init
containerd version: 1.7.24~ds1-5+b1
runc version: 1.1.15+ds1-2+b3
init version:
Security Options:
apparmor
seccomp
Profile: builtin
cgroupns
Kernel Version: 6.12.28-current-meson64
Operating System: Armbian 25.5.0-trunk.542 trixie
OSType: linux
Architecture: aarch64
CPUs: 6
Total Memory: 3.678GiB
Name: odroidn2
ID: 588d9329-d9b3-4516-adbb-33a1cb46e3a4
Docker Root Dir: /var/lib/docker
Debug Mode: false
Experimental: false
Insecure Registries:
127.0.0.0/8
Live Restore Enabled: false

[itzg]

Thanks for posting also @EvinRobertson . Definitely some commonalities in host OS there and roughly similar hardware. I was curious if kernel versions lined up but there's a few minor revisions difference.

Can you also provide output of

docker run -it --rm --entrypoint bash itzg/minecraft-server -c 'ls /usr/share/mc-image-helper-*/lib'

It will be interesting to sanity check the classpath content where that logback class should be coming from.

[EvinRobertson]

$ docker run -it --rm --entrypoint bash itzg/minecraft-server -c 'ls /usr/share/mc-image-helper-*/lib'

accessors-smart-2.5.0.jar jaxb-runtime-2.3.5.jar netty-handler-4.1.119.Final.jar
annotations-26.0.2.jar json-path-2.9.0.jar netty-handler-proxy-4.1.119.Final.jar
asm-9.3.jar json-smart-2.5.0.jar netty-resolver-4.1.119.Final.jar
classgraph-4.8.21.jar kotlin-reflect-1.3.50.jar netty-resolver-dns-4.1.119.Final.jar
commons-codec-1.18.0.jar kotlin-scripting-common-1.3.50.jar netty-resolver-dns-classes-macos-4.1.119.Final.jar
commons-compress-1.27.1.jar kotlin-scripting-compiler-embeddable-1.3.50.jar netty-resolver-dns-native-macos-4.1.119.Final-osx-x86_64.jar
commons-io-2.16.1.jar kotlin-scripting-compiler-impl-embeddable-1.3.50.jar netty-transport-4.1.119.Final.jar
commons-lang3-3.16.0.jar kotlin-scripting-jvm-1.3.50.jar netty-transport-classes-epoll-4.1.119.Final.jar
cxf-core-3.5.11.jar kotlin-script-runtime-1.3.50.jar netty-transport-native-epoll-4.1.119.Final-linux-x86_64.jar
httpclient5-5.4.3.jar kotlin-stdlib-1.3.50.jar netty-transport-native-unix-common-4.1.119.Final.jar
httpcore5-5.3.4.jar kotlin-stdlib-common-1.3.50.jar picocli-4.7.7.jar
httpcore5-h2-5.3.4.jar kotlinx-coroutines-core-1.1.1.jar plexus-utils-3.5.1.jar
istack-commons-runtime-3.0.12.jar logback-classic-1.3.15.jar reactive-streams-1.0.4.jar
jackson-annotations-2.18.3.jar logback-core-1.3.15.jar reactor-core-3.7.5.jar
jackson-core-2.18.3.jar maven-artifact-3.9.9.jar reactor-netty-core-1.2.5.jar
jackson-databind-2.18.3.jar mbknor-jackson-jsonschema_2.13-1.0.39.jar reactor-netty-http-1.2.5.jar
jackson-dataformat-toml-2.18.3.jar mc-image-helper-1.41.9.jar scala-library-2.13.1.jar
jackson-dataformat-xml-2.18.3.jar netty-buffer-4.1.119.Final.jar slf4j-api-2.0.11.jar
jackson-dataformat-yaml-2.18.3.jar netty-codec-4.1.119.Final.jar snakeyaml-2.3.jar
jackson-datatype-jsr310-2.18.3.jar netty-codec-dns-4.1.119.Final.jar stax2-api-4.2.2.jar
jakarta.activation-1.2.2.jar netty-codec-http2-4.1.119.Final.jar txw2-2.3.5.jar
jakarta.activation-api-1.2.2.jar netty-codec-http-4.1.119.Final.jar validation-api-2.0.1.Final.jar
jakarta.xml.bind-api-2.3.3.jar netty-codec-socks-4.1.119.Final.jar woodstox-core-7.0.0.jar
jansi-2.4.1.jar netty-common-4.1.119.Final.jar xmlschema-core-2.3.1.jar

$ docker run -it --rm --entrypoint bash itzg/minecraft-server -c 'unzip -l /usr/share/mc-image-helper-1.41.9/lib/logback-classic-1.3.15.jar | grep ch/qos/logback/classic/joran/action/LoggerContextListenerAction'

1981  2024-12-28 13:05   ch/qos/logback/classic/joran/action/LoggerContextListenerAction.class

$ docker run -it --rm --entrypoint bash itzg/minecraft-server -c 'unzip -l /usr/share/mc-image-helper-1.41.9/lib/logback-classic-1.3.15.jar | grep ch/qos/logback/classic/joran/action/ContextNameAction'

 934  2024-12-28 13:05   ch/qos/logback/classic/joran/action/ContextNameAction.class

[itzg]

Thanks. The jar and class within are definitely there -- thanks for drilling into those.

My only theory so far is that apparmor and/or seccomp is blocking the loading/execution of those. I would have to research where to watch the logs for that and/or enable permissive mode to troubleshoot.