Install Java 25¶
JMusicBot needs Java 25 or newer. Older versions, including the Java 8, 11 or 17 the original JMusicBot used, won't start it.
Using Docker?
Skip this page. The Docker image already includes Java.
Check what you have¶
Open a terminal (PowerShell on Windows) and run:
java -version
If the first line says 25 or higher, such as java version "25.0.3" or openjdk version "25", you're done with
this step. If it says a lower number, or java isn't found, install Java 25 below.
Install it¶
Any Java 25 build works. These steps use Eclipse Temurin, a free build from the Adoptium project.
- Go to adoptium.net and pick Windows, x64, JRE (or JDK), version 25.
- Download the
.msiinstaller and run it. On the "Custom Setup" screen, turn on Set JAVA_HOME and Add to PATH. - Close and reopen PowerShell, then run
java -versionagain.
- Go to adoptium.net and pick macOS, your chip (aarch64 for Apple silicon, x64 for Intel), version 25.
- Download the
.pkginstaller and run it. - Open a new Terminal window and run
java -version.
If you use Homebrew, brew install --cask temurin@25 does the same.
Many distributions package Java 25. On Debian and Ubuntu, try:
sudo apt update
sudo apt install openjdk-25-jre-headless
If your release doesn't have it, add the Adoptium repository by following
Adoptium's Linux instructions, then install
temurin-25-jre. Run java -version to check.
Linux: check glibc¶
The bot's voice libraries need glibc 2.38 or newer. Check with:
ldd --version
The first line ends with the version, such as 2.39. Ubuntu 24.04 and Debian 13 already have 2.38 or newer.
Older systems, such as Ubuntu 22.04 or Debian 12, don't, and the bot's voice libraries fail to load there.
On those, upgrade the system or use Docker, which brings its own.
On Debian and Ubuntu you may also need the audio libraries:
sudo apt install libopus0 libsodium23
Next: Get a bot token.