Hoe installeer ik Java op mijn VPS?

Wie een Minecraft-server of een andere Java-toepassing op een VPS wil draaien, heeft eerst een Java-runtime nodig. Op Ubuntu en Debian installeer je die met apt in een paar commando's. Let op de versie: Minecraft 26.x vereist Java 25, 1.20.5 tot 1.21 Java 21, 1.18 tot 1.20.4 Java 17 en oude modpacks Java 8. Welke versie bij welke Minecraft-versie hoort, staat in ons blogartikel welke Java-versie je server nodig heeft.

Stap 1: verbinden met je VPS

Maak verbinding via SSH als root met het IP-adres en het wachtwoord uit je opleveringsmail; hoe dat werkt met PuTTY of de terminal staat in verbinden met de SSH van je VPS. Werk je niet als root, zet dan sudo voor de commando's hieronder.

Stap 2: pakketlijst bijwerken

apt update && apt upgrade -y

Dit haalt de nieuwste pakketlijsten op en werkt het systeem bij. Doe dit altijd voordat je nieuwe software installeert.

Stap 3: Java installeren

Kies de versie die je nodig hebt. Ubuntu 24.04 en Debian 13 hebben de recente versies in hun eigen pakketbronnen:

• Java 25: apt install openjdk-25-jre-headless -y
• Java 21: apt install openjdk-21-jre-headless -y
• Java 17: apt install openjdk-17-jre-headless -y

headless betekent zonder grafische onderdelen; precies wat een server nodig heeft. Wil je ook compileren (voor plugins ontwikkelen), neem dan -jdk-headless in plaats van -jre-headless. Het generieke pakket default-jre installeert de standaardversie van je distributie, maar dat is niet altijd de versie die Minecraft wil; kies liever expliciet.

Staat een versie niet in de pakketbronnen van je distributie (bijvoorbeeld Java 25 op een oudere Ubuntu), gebruik dan de pakketten van Adoptium (Eclipse Temurin): voeg hun repository toe volgens de instructies op adoptium.net en installeer temurin-25-jre. Ook Java 8 haal je daar het makkelijkst vandaan.

Stap 4: controleren

java -version

Je ziet nu bijvoorbeeld openjdk version "25.0.1". Klopt de versie, dan is Java klaar voor gebruik.

Meerdere versies naast elkaar

Draai je op één VPS een 26.x-server en een oud modpack, dan installeer je gewoon beide versies. Welke versie het commando java gebruikt, kies je met:

update-alternatives --config java

Beter is om in het startscript van elke server het volledige pad te gebruiken, bijvoorbeeld /usr/lib/jvm/java-25-openjdk-amd64/bin/java -Xmx4G -jar paper.jar. Dan maakt het niet uit wat de systeemstandaard is, en verandert er niets als een apt upgrade de standaard verzet.

Geheugen instellen

Geef Java niet al het geheugen van de VPS: laat ongeveer 1 GB over voor het besturingssysteem. Op een VPS van 8 GB start je een Minecraft-server dus met -Xms6G -Xmx6G. De veelgebruikte "Aikar's flags" voor de garbage collector zorgen voor minder hikken bij grote werelden en werken op Java 21 en 25.

Een server als service draaien

Start een server niet los in je SSH-sessie, want dan stopt hij zodra je de verbinding verbreekt. Gebruik een systemd-service of een scherm-sessie (screen of tmux). Wil je meerdere servers beheren met een paneel, installeer dan Pterodactyl; zie Pterodactyl handmatig installeren.

Veelgestelde vragen

• "Unable to locate package openjdk-25-jre-headless". Je distributie heeft die versie niet; gebruik Adoptium of upgrade de distributie.
• De server meldt "UnsupportedClassVersionError". De actieve Java is te oud; kies de juiste versie met update-alternatives of het volledige pad.
• Java gebruikt te veel geheugen. Verlaag -Xmx; Java neemt wat je toestaat.

Kom je er niet uit, open dan een ticket met de uitvoer van java -version en lsb_release -a.