How do I run a custom or unlisted JAR (Waterfall, Velocity, Magma, a specific fork)?

If the software or build you want isn't in the Software page's catalog — a specific proxy like Waterfall or Velocity, a hybrid like Magma, or a particular fork — you can install it manually. It's a straightforward file-and-startup job.

Installing a custom JAR

1. Download the .jar from the official source.
2. Open Files and upload it to the server root (where server.properties lives).
3. Rename it to exactly server.jar — our startup script looks for that name — or set the JAR name in the SERVER JAR FILE variable on the Settings page.
4. Start from the Console.

Proxies and custom flags

For proxies (Velocity/Waterfall) the same steps apply. You may also want custom startup flags for these.

Tip: For proxies you'll often want custom startup flags — see the startup-command answer for how to set them.

Frequently asked questions

Where do I put the JAR? In the server root, alongside server.properties, via the Files manager.

Do I have to rename it to server.jar? Either rename it to server.jar, or point the SERVER JAR FILE variable on the Settings page at your file.