How to Change Your Minecraft Server Java Version

Choose the Java runtime your Minecraft server needs. Check your game and loader requirements, update the panel image and fix Java version errors.

Your hosted server’s Java runtime is separate from Minecraft’s game version and the Java installed on your computer.

Visual guide: match the whole setup before installing content. See the steps for the exact settings used by this game.

Choose the required Java version

Minecraft 1.20.5 through 1.21.11 requires Java 21. Minecraft 26.1 requires Java 25. Older games and modpacks can need older Java, so check the exact software or pack requirements.

Troubleshooting checks

If the result is not what you expected
What you seeWhat to check
Unsupported class version errorCompare the required Java release with the selected Java image.
Switching Java does not fix a mod conflictJava is the runtime; it does not change the Minecraft release, loader or installed mods.

References: Minecraft 1.20.5, Minecraft 26.1 and Paper Java requirements.

Change the runtime

  1. Open Startup and choose the required Java version in Docker Image.
  2. If the required version is not listed or the field is locked, contact Konnect support to change it.
  3. Restart the server. Check the Java runtime and complete startup in Console, then join with the correct game or pack release.

The Paper, Fabric and NeoForge eggs list supported Java images. Available choices depend on your server type.

If startup fails

UnsupportedClassVersionError usually means the named file needs a newer Java runtime. A mod or plugin can require newer Java than the base server. Unable to access jarfile instead points to a missing or incorrect launch file. Keep Forge or NeoForge’s required argument file format.

Further help: Paper startup troubleshooting.

Related: Change Minecraft version · Install a modpack.

Was this article helpful?

Your feedback helps us improve our guides.

Written by Konnect HostingUpdated 2 min read