install_desktop Installation · Free & open source

Run Klacks yourself — on your own infrastructure.

Two paths, one result: the guided on-prem installer, or the Docker Compose stack for your own setup. The country package ships with your country's public holidays, working-time rules, surcharges and industry presets — no registration, no licence fees.

Country package

Pick your industry — optional

Your choice is written into the country profile as a preset and determines which industry blocks are active on first start. The package always contains every industry — you can activate more in the app at any time.

dns

On-prem installer

The guided path for your own server: an install script generates secrets and a self-signed certificate, pulls the latest released version and brings up the whole stack — on Linux or Windows.

Requirements
  • check_circle Docker Desktop (Windows/Mac) or Docker Engine with the Compose plugin (Linux)
  • check_circle Outbound access to ghcr.io and github.com (images and automatic updates)
  • check_circle Free ports 80 and 443 (configurable)
Three steps
  1. 1
    Download and extract Download the ZIP for your country and extract it on the target machine.
  2. 2
    Run the install script Run the bundled shell script on Linux, or the PowerShell script on Windows. It generates secrets and the certificate, applies the country profile and waits until the stack is healthy.
  3. 3
    Log in and change the password Log in from your browser and immediately change the initial password listed in the bundled README.
download Download on-prem package

klacks-onprem-kr-all.zip

deployed_code

Docker Compose

The direct path for teams that manage their own container stacks: docker-compose.yml, nginx configuration, init scripts, the country profile and a prepared .env template with every variable — you keep full control.

Requirements
  • check_circle Docker Engine with the Compose plugin (or Docker Desktop)
  • check_circle Outbound access to ghcr.io and github.com (images and automatic updates)
  • check_circle Experience running Docker Compose stacks
Three steps
  1. 1
    Download and extract Download the Compose ZIP for your country and extract it — the bundled README walks through every step.
  2. 2
    Set up .env Copy the .env.example template to .env and set the server name plus passwords/secrets. The path to the country profile is already prefilled.
  3. 3
    Start the stack Run “docker compose up -d”, log in from your browser and change the initial password immediately.
download Download Compose package

klacks-compose-kr-all.zip

description

Profile only — for existing installations

Already running Klacks? The profile (JSON) carries the country presets — public holidays, working-time rules, surcharges and industries — and is applied on an installation's first start. It is also the way to add another industry with its presets later.

description Download profile (JSON)

Good to know

code

Open source (MIT)

The complete source code is public on GitHub under the MIT licence — no licence fees, no vendor lock-in.

storage

Data stays in-house

Klacks runs on your infrastructure. Staff and scheduling data never leave your server — there is no forced cloud.

update

Automatic updates

The installation pins the latest released version; an update service inside the stack applies newly released versions automatically.

lock

HTTPS from the start

The installer generates a self-signed certificate to get you started — you can switch to your own certificate at any time. Change the initial password right after the first login.

Try first, install later?

The Playground lets you test Klacks right in the browser with sample data — no installation, no registration. Or take a look at the source code on GitHub.

code View on GitHub
An error has occurred. This application may no longer respond until reloaded. Reload X