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.

info
There is no preconfigured country package for this country yet. You can still install Klacks in full: the standard package contains everything except the country presets. You then set up public holidays, working-time rules and surcharges in the app.
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.
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.

There is no separate Compose package for this country yet — the standard package contains the complete Docker Compose stack.

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