docker-minecraft-proxy

Lightweight Docker/container images for Minecraft proxies.

Running

WARNING: The following container is ephemeral, meaning any changes made to it will be discarded.

$ docker run --rm -it -p 25565:25577 ghcr.io/cubxity/minecraft-proxy:velocity-temurin17-jammy

• --rm removes the container on exit
• -i keeps STDIN open
• -t allocates a pseudo-TTY
• -p publish port(s) to the host

This image makes use of Velocity's recommended flags by default. The data directory is located at /data.

Environment variables

• MEMORY defaults to 1G
• INIT_MEMORY Initial memory to allocate to the JVM. Defaults to MEMORY
• MAX_MEMORY Maximum memory to allocate to the JVM. Defaults to MEMORY
• JVM_XX_OPTS -XX JVM argument overrides
• JVM_OPTS JVM arguments to append

Variants

This repository provides OpenJDK and Eclipse Temurin based container images for Velocity.

⚠️ AdoptOpenJDK (adopt*) and OpenJDK (java*) variants are deprecated in favor of Eclipse Temurin. Support for non-LTS versions may be dropped at any time.

Eclipse Temurin Alpine (temurin*-alpine)

Supports linux/amd64.

This image is based on Eclipse Temurin's Alpine image. The image format is suffixed with -temurin<version>-alpine.

Examples:

• velocity-temurin17-alpine
• velocity-3.2.0-SNAPSHOT-temurin17-alpine

Eclipse Temurin Ubuntu Jammy (temurin*-jammy)

Supports linux/amd64 and linux/arm64.

This image is based on Eclipse Temurin's Ubuntu Jammy Jellyfish image. The image format is suffixed with -temurin<version>-jammy.

Examples:

• velocity-temurin17-jammy
• velocity-3.2.0-SNAPSHOT-temurin17-jammy