How To Change the Java Version on Your Minecraft Server

4 min. readlast update: 09.09.2024

When managing a Minecraft server, it's crucial to use the correct Java version that matches the Minecraft game version you want to play. Whether you're installing a new modpack, restoring a backup, or switching to a different Minecraft version, the server's Java version might not automatically update on your server. Here's a step-by-step guide to manually update the Java version on your server in this situation.

๐Ÿ‘‹ Don't forget to create a back of your server before making any changes, including changing your Java version. Here is a guide on creating a backup of your server!


๐Ÿ“ข Important Information Before Getting Started

๐Ÿ’ก Terms commonly used to refer to the Java version: 

  • Java Image
  • Docker Image
  • Java Version

Each version of Minecraft requires a specific Java version to function properly. This includes your server as well.  Refer to the following table to identify which Java version you need based on the Minecraft game version installed on your server:

Java 8
  • Compatible Minecraft versions: 1.8 to 1.16.5
Java 11
  • Compatible Minecraft versions: 1.13 to 1.17.1
Java 16
  • Compatible Minecraft versions: 1.17 to 1.18.2
Java 17
  • Compatible Minecraft versions: 1.18 to 1.20.6
Java 21
  • Compatible with Minecraft 1.18+, and required for Minecraft 1.21+

Unsupported Java Version Popup

๐Ÿ’ก Sometimes, when you press the 'Start' button on your server's console, a popup may appear indicating that your server is using an 'unsupported Java version'. To resolve this, simply click the 'Update Docker Image' button in the bottom-right corner of the popup. This will automatically restart the server and install the correct Java version. If the popup appears again, just click 'Update Docker Image' again.

If this resolves the issue, no further action is needed. However, if the Java version still doesn't update, additional troubleshooting may be required.

Incorrect Java Version Console Error Log Example

๐Ÿ’ก Here's an example of what your console logs might display when starting the server with the wrong Java version. Note that logs and errors can vary.

๐Ÿ”Getting Started ๐Ÿ”

Step 1: Finding & Changing the Java Version on your Server

  1. Make sure you're logged into the Control Panel to be able to access your server.
  2. Once you have your server's control panel open, navigate to the "Settings" tab.
  3. Scroll down to find the section labeled "Startup Options."
  4. In the "Startup Options" section, find the option labeled Java Image (this refers to your Java version).
  5. Click on the dropdown menu next to Java Image number currently selected and then select the required Java version for your server (refer to the compatibility list above if needed).

    1. For example, if you're running Minecraft 1.17, select Java 16.
    2. For Minecraft 1.18 or later, select Java 17.

Step 2: Restart Your Server

  1. After selecting the correct Java version, navigate to the "Console" tab.
  2. Turn your server back online. If there are no other issues, your server should boot up correctly with the updated Java version.

๐Ÿšง Troubleshooting Tips ๐Ÿšง

If you're still encountering problems after changing the Java version, consider the following tips:

  • Double-check the Minecraft version: Ensure that the game version installed on your server matches the Java version you selected.
  • Double-check Java Version: Go back to the server's settings tab and make sure the correct java version was selected for your server.
  • Mods or Plugins Compatibility: Some mods and plugins may not function correctly if they aren't compatible with newer Java versions. Revert to a supported Java version if this is the case.

๐Ÿ”จ If you need help, don't hesitate to reach out to our support team by submitting a Support Ticket or contacting us directly via LiveChat!

Was this article helpful?