SFS2X Docs / AdvancedTopics / jre-compatibility
» Java Runtime (JRE) Compatibility
At the time of writing this article (September 2021) SmartFoxServer 2X ships with an embedded 64-bit JRE-8, allowing to run the server without the need of external dependencies.
SFS2X can also run with a range of alternative Java runtimes, including more recent versions and from different vendors. In this short guide we provide a map of which JREs can be used and the process to replace the default runtime.
» Supported vendorsWe have tested SmartFoxServer 2X with different Java Runtimes from multiple vendors and we can recommend the following:
The embedded JRE-8 provided in SmartFoxServer 2X is an AdoptJDK distribution. They offer a wide range of pre-built JREs/JDKs supporting all platform and architectures (ARM included) and they are our current go-to provider.
» Supported Java versions
If you need to deploy Java code that relies on a more recent JDK release you can refer to the following compatibility table.
|JDK Version||End of free updates||Supported|
|JDK 8 (LTS)||2026 for AdoptJDK / Corretto, 2030 for Oracle / OpenJDK||YES|
|JDK 9||March 2018||YES|
|JDK 10||September 2018||YES|
|JDK 11 (LTS)||2024 for AdoptJDK, 2027 Corretto||YES|
|JDK 12||September 2019||YES|
|JDK 13||March 2020||YES|
|JDK 14||September 2020||YES|
|JDK 15||March 2021||YES(*)|
|JDK 16||September 2021||YES(**)|
Unless you're bound to specific JDK versions we highly recommend sticking with an LTE release.
(**) = SFS2X will not run out of the box with Java 16. You need to add a
--illegal-access=permit in the launch scripts, to enable the legacy Reflection API.
Further Java Release details
For a more detailed list of the changes in each Java release we highly recommend this Wikipedia summary.
» Replacing the default Java RuntimeTo replace the default JRE with a new one you can follow these simple steps:
- Download the JRE matching your OS and architecture from your chosen vendor.
- Stop SmartFoxServer 2X, if it is running.
- Replace the default jre/ folder found under the main SmartFoxServer_2X/ directory.
- Start SmartFoxServer 2X and check the logs to make sure the boot was successful.