Velocity

Overview

This template is set up to use the Velocity part of itzg/mc-proxy. It is a Docker image that provides a choice of Minecraft proxies, the exposed variables configure it for Velocity. It is intended to be used in combination with itzg/minecraft-server containers.

Requirements

Requires a //Minecraft\\ server. Preferably from the itzg/minecraft-server image.

Runtime arguments

Network: bridge
Shell: sh
Privileged: false
Extra Params: --restart unless-stopped

Template configuration

PortPorttcp

Port of your Minecraft proxy; How you want to access it.

Target: 25565
Default: 25565
Value: 25565

Server Proxy FilesPathrw

Leave blank for Unraid default appdata location

Target: /server

Server TypeVariable

Sets the server proxy type

Target: TYPE
Default: VELOCITY
Value: VELOCITY

Enable Remote ConnectionVariable

Enable remote connection, needed for many chat features.

Target: ENABLE_RCON
Default: true
Value: true

MemoryVariable

See: https://docs.papermc.io/velocity/tuning/

Target: MEMORY
Default: 512m
Value: 512m

Server Icon URLVariable

URL to icon for server

Target: ICON

Java Runtime OptionsVariable

Space seperated: Consider adding -XX:MaxRAMPercentage={n} (with {n} replaced); the JVM default is 25%.

Target: JVM_XX_OPTS

Java Runtime OptionsVariable

Commands after JVM_XX_OPTS

Target: JVM_OPTS

PluginsVariable

Used to download a comma seperated list of *.jar urls to the plugins folder.

Target: PLUGINS

Enable Remote ConnectionVariable

Default is to be on

Target: ENABLE_RCON

Remote Connection PortPorttcp

Target: 25575

Remote Connection PasswordVariable

Strong Secure Password

Target: RCON_PASSWORD

Velocity ConfigPathro

Velocity configuration file location. Leave blank for unraid default

Target: /config

Forwarding SecretPathro

Velocity plugin location. Leave blank for Unraid default

Target: /plugins

Icon OverrideVariable

Set this URL to overwrite an existing ICON

Initial MemoryVariable

Target: INIT_MEMORY

Max MemoryVariable

Target: MAX_MEMORY

Velocity VersionVariable

Which Image to download; defaults to

Target: VELOCITY_VERSION

Velocity Build IDVariable

Pin to a specific build within a version

Target: VELOCITY_BUILD_ID

Links

Template Support Docker Hub Project

Details

Repository

itzg/mc-proxy

Registry

https://registry.hub.docker.com/r/itzg/mc-proxy

Last Updated2026-04-18

First Seen2025-05-28

Run Velocity on Unraid.

Velocity is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS