Skip to main content

Required Software

  • Updated OS
  • Java
  • MariaDB (or MySQL)
  • Git

Update the OS

sudo -i
apt update

Get & Install Java

L2J is built using Java, to build you need Java JDK as well.

apt install -y temurin-21-jdk

Check the Java version

java -version

If you have multiple versions you can configure them by using alternatives:

update-alternatives --config 'java'

We recommend updating the JAVA_HOME environment variable.


As long as it's possible, L2J will be compatible with the latest LTS (Long-Term-Support) version of Java, you can check the roadmap for Java SE here.

Get & Install Git

L2J uses Git as version control system on BitBucket, use it to get the latest versions.

apt install -y git

Check the Git version

git --version

We recommend getting the source code directly from our public repositories.

Get & Install the Database Server

Download and install a database server and create a specific user.

apt install -y mariadb-server

Secure your database installation


Execute the following SQL statements to create a L2J specific database user:

mariadb -u root -p
CREATE OR REPLACE USER 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
GRANT ALL PRIVILEGES ON *.* TO 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';

We recommend changing the default database password. If you do it, you need to edit files inside the game server config folder and the login server config folder.


We recommend (optionally) downloading and installing HeidiSQL or DBeaver to manage the database.


L2J is compatible with MySQL 8.0+, but we recommend MariaDB.