Velocity
This template is set up to use the Velocity part of itzg/mc-proxy.
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
Security check: 1 serious finding
- A private key is committed in the source code (proxy/src/main/java/com/velocitypowered/proxy/crypto/EncryptionUtils.java:51)
Automated checks on commit 77274a8, 23 Oct 2026. Not an audit.
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
Variants
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
- Reddit (reddit)
- Can I use Velocity to proxy to my home server? - Reddit (reddit)
Collected 42 days ago - public community threads