From fd3655be88945d6dc3b3e0ec934e95828376f44e Mon Sep 17 00:00:00 2001 From: Geoff Bourne Date: Fri, 4 Apr 2025 14:51:45 -0500 Subject: [PATCH] docs: added info about image labels (#3398) --- docs/misc/troubleshooting.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/docs/misc/troubleshooting.md b/docs/misc/troubleshooting.md index 21a4d377..55458b95 100644 --- a/docs/misc/troubleshooting.md +++ b/docs/misc/troubleshooting.md @@ -5,3 +5,33 @@ To troubleshoot just the command-line used to start the Minecraft server, set th To troubleshoot any issues with memory allocation reported by the JVM, set the environment variable `DEBUG_MEMORY` to `true`. If you are experiencing any issues with the "Changing ownership of /data" step, that can be disabled by setting `SKIP_CHOWN_DATA` to `true`. + +To confirm the image version that has been pulled, use the following command, replacing `itzg/minecraft-server` as needed for specific image tags: + +## Image labels + +```shell +docker image inspect itzg/minecraft-server -f "{{json .Config.Labels}}" +``` + +such as + +```json +{ + "org.opencontainers.image.authors": "... <...@gmail.com>", + "org.opencontainers.image.created": "2025-04-03T02:15:51.405Z", + "org.opencontainers.image.description": "Docker image that provides a Minecraft Server for Java Edition that automatically downloads selected version at startup", + "org.opencontainers.image.licenses": "Apache-2.0", + "org.opencontainers.image.ref.name": "ubuntu", + "org.opencontainers.image.revision": "d6897a649ecbc16b5fb2e1500e24b64ef80270a0", + "org.opencontainers.image.source": "https://github.com/itzg/docker-minecraft-server", + "org.opencontainers.image.title": "docker-minecraft-server", + "org.opencontainers.image.url": "https://github.com/itzg/docker-minecraft-server", + "org.opencontainers.image.version": "java21" +} +``` + +The labels that are most interesting are: +- org.opencontainers.image.created +- org.opencontainers.image.revision, which maps to https://github.com/itzg/docker-minecraft-server/commit/{revision} +- org.opencontainers.image.version \ No newline at end of file