How To Setup A Velocity Minecraft Proxy

Last updated 05 Feb 2026

Need a Minecraft server?

Spin one up fast with our feature-rich panel and seriously low prices.

Setting up the Proxy

  1. Login to the Kinetic Panel

  2. Stop your server by clicking the power button, then click the square icon.

  3. In this case, you will need a Proxy server and two other servers that your Proxy will connect to; For example, a Hub and Minigames server.

  4. First, you'll need to ensure that you have the correct proxy software installed. To do this, go to "Change game" on your game section.

  5. In this Change Game menu, you'll be able to search "Velocity" or check the category for "Proxy software's". You'll then see Velocity Proxy on the right side, where you can install it.

  6. After you've confirmed that you've installed the Velocity Proxy software on your server, you will need to go to your file manager menu.

  7. In the file manager, you'll see a button on the top right of the screen where you can create files. You'll need to create a file.

  8. When creating the file, you'll need to input the forwarding secret password that Velocity gave you. Once you've entered the password, click "Create file" on the top right.

    notice
    If Velocity has not given you a password, you can create your own instead.
  9. When setting the name for the file, you'll need to name it "forwarding.secret". Then click "Create File"

  10. Once you've completed these steps, you'll then need to find and open your "velocity.toml" file. If the file appears to be empty for some unknown reason, you can open the file and input the text from this link.

  11. In the velocity.toml file, scroll down till you find the "servers" line. Here, you can rename the IP's to what you like. For the purpose of this guide, we will be keeping them as default.

    notice
    If you're not using a domain to connect your porxy, you'll need to remove the [forced-hosts] section from your velocity.toml file.
File Manager

From there, you should be all set in the Velocity config.

Setting up the Individual Servers.

Now that you have the Velocity Configuration out of the way, we need to get your playable servers ready to go. You will be doing this for every server that you want connected to the proxy.

  1. Stop your server by clicking the power button, then click the square icon.

  2. Location and open your settings menu.

  3. In the settings menu, click the "server properties" tab.

  4. You'll then find a search bar. Here, you can search "online-mode", and switch the online mode value from "true", to "false".

  5. Once you've made the change, click the "save" button on the top right of the screen.

  6. Locate and open your file manager.

  7. In the file manager, find and open your config folder.

  8. In the config folder, you'll find a file called paper-global.yml. You'll need to open it.

  9. In the paper-global.yml file, scroll down till you find the proxies category. You'll need to set velocity to enabled, and enter your forwarding secret password aswell.

  10. Once you've made the changes, click "save" on the top right on the screen.

Troubleshooting

Make sure you are using the PROXY server connection address to connect.

If you are getting an error connecting to the proxy, head to the velocity.toml file & set the "player-info-forwarding-mode" to modern. This will sync your players UUIDs and IPs for the login process.

If you are experiencing issues with your proxy & need assistance please reach out to our 24/7/365 support team by Submitting a Ticket

Kinetic Hosting Logo

Our goal at Kinetic is to offer genuinely helpful, human-powered support (no bots, no AI), combined with a feature-rich panel, powerful hardware, and prices that won’t break the bank.

Registered in England & Wales • Co. No. 11439987 • ICO No. ZA841955

Kinetic Hosting and the Kinetic Hosting logo are trademarks of Dapper Fox Group LTD. All other trademarks are the property of their respective owners.