Velocity

This template is set up to use the Velocity part of itzg/mc-proxy.

  • Game Servers
  • Network Services
  • Other
  • Tools & Utilities
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.

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

59/100 Fair

Maintained
100last commit 14 days ago
Popular
672,289 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
2032 GB minimum RAM, runs on ARM
Security check
201 serious finding, CI, tests, OpenSSF Scorecard 3.3/10

Availability: platform listings confirmed today, links checked 38 days ago

GitHub stars
2,289
Open issues
206
Last commit
2026-10-28
Latest release
v4.3.1
License
GPL-3.0
Activity
declining

Checked 10 days ago - source: GitHub (VelocityPowered/Velocity)

Resources & Compatibility

Minimum requirements: 32 GB RAM, 1024 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 43 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the Velocity CLI first Run the Homebrew commands in your terminal to install the Velocity command-line tool. If you skip this, you won’t have the Velocity commands needed to set up or run the app. source
  • Set up the app’s .env settings Create a .env file (a plain text settings file) with basic values like LOG_DRIVER=console, CACHE_DRIVER=memory, and QUEUE_DRIVER=memory. These tell the app where to send logs, how to store temporary data, and how to handle later tasks, and missing or unsupported values can stop it from starting. source

Fetched 27 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I get the Velocity proxy JAR without building it?

You can get the proxy JAR from the downloads page.

What does Velocity generate on first start?

Velocity generates a default configuration file that you can configure from there.

How do I build Velocity from source?

Use the Gradle wrapper and run the full build cycle, for example ./gradlew build.

Where can I find plugins for Velocity?

Hangar is the dedicated plugin repository for Velocity and currently lists 428 plugins built for it.

Where can I get help with proxy settings or server lag?

You can use the documentation, and the Discord community provides support from staff and community members.

Answers sourced from github.com, papermc.io

Community

Collected 42 days ago - public community threads