Getting Started

📦 Running Kala Server

Requirements

• JDK 17+
• Docker (optional, for containerized deployment)
• PostgreSQL + PostGIS (recommended)
• SpatiaLite (optional)
• GDAL (for raster support)
• Justfile (optional, for build script)

Before You Start

• Create a config.toml file

prefixPath = ""
hostname = "localhost"
#port = 8888
fileStoreRoot = "/kala-server/public"

[db]
#url = "localhost:5432"
url = "/kala-server/config.sqlite"
username = ""
password = ""
dbname = ""

[jwt]
domain = "kala::server"
audience = "kala::server::user"
realm = "kala::server::user"
secret = "kala::server" # replace this with random

[security]
encryptionKey = "/kala-server/default.key"

• Define sqlite database location at db.url
• Define publicDir and fileStoreRoot directories

Running

There are two main options to run Kala Server: using Docker or manually setting it up. But the docker needs the app to be built first/

Option 1: Using Docker

1. Create volumes which contain previouse files and directories
2. Run docker compose

docker compose up -d

Docker Compose includes:

• kala-service: Main server
• postgis: PostgreSQL with PostGIS support

Option 2: Manual Setup

git clone https://github.com/your-org/kala-server.git
cd kala-server
./gradlew buildFatJar
java -jar build/libs/kala-server-all.jar -c config.toml

After successfully running, you can access the Kala Server at http://localhost:10211.