Installation Guide

Follow this step-by-step guide to install and configure your L2jExalted server.

Step 1: Download Server Files

1. Log in to your account at account dashboard
2. Navigate to the Downloads section
3. Download the latest release for your tier
4. Extract the ZIP file to your desired location

unzip L2jExalted-v1.0.0-FULL.zip -d /opt/l2jexalted

Step 2: Install Java 17

L2jExalted requires Java 17 or higher to run.

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install openjdk-17-jdk
java -version  # Verify installation

Windows

1. Download Java 17 from Adoptium.net
2. Run the installer and follow the prompts
3. Verify installation by opening Command Prompt and running: java -version

Step 3: Install PostgreSQL

The server uses PostgreSQL as its database.

Linux (Ubuntu/Debian)

sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql
sudo systemctl enable postgresql

Windows

1. Download PostgreSQL from postgresql.org
2. Run the installer (choose PostgreSQL 14 or higher)
3. Remember the password you set for the postgres user

Step 4: Create Database

Create a dedicated database for L2jExalted:

# Login to PostgreSQL
sudo -u postgres psql

# Create database and user
CREATE DATABASE l2jexalted;
CREATE USER l2jadmin WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE l2jexalted TO l2jadmin;

# Exit
\q

Step 5: Configure Server

Edit the configuration files in the config/ directory:

database.properties

# Database connection
db.url=jdbc:postgresql://localhost:5432/l2jexalted
db.username=l2jadmin
db.password=your_password
db.max_connections=50

server.properties

# Server settings
server.name=My L2jExalted Server
server.ip=127.0.0.1
server.port=7777
login.port=9014

# Rates (BASIC tier default)
rates.xp=1.0
rates.sp=1.0
rates.adena=1.0

Step 6: Install License

Copy your license key file to the config folder:

# Download your license.key from the account dashboard
# Place it in the config folder
cp license.key /opt/l2jexalted/config/license.key

Step 7: Import Database Schema

Import the initial database schema:

# Navigate to server directory
cd /opt/l2jexalted

# Import schema
psql -U l2jadmin -d l2jexalted -f sql/install.sql

Step 8: Start the Server

Launch the game server and login server:

Linux

# Make scripts executable
chmod +x startGameServer.sh
chmod +x startLoginServer.sh

# Start login server first
./startLoginServer.sh

# Wait 10 seconds, then start game server
./startGameServer.sh

Windows

1. Double-click startLoginServer.bat
2. Wait for it to finish loading (about 10 seconds)
3. Double-click startGameServer.bat

Verification

Check that everything is working:

Next Steps

• First Run Guide - Create admin account and configure basics
• Configuration Guide - Customize rates, events, and features
• Troubleshooting - Common issues and solutions