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 SE, to build you need Java JDK as well.

apt install -y openjdk-17-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 (optionally) downloading and installing HeidiSQL or DBeaver to manage the database.


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