You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
patdyn a336838af8 Merge branch 'main' of ssh:// 3 weeks ago
.idea-configs refactor: *.k3s -> server 2 years ago
.run [skip ci] adjust module names for tests 4 weeks ago
doc [Skip-CI] Added doc, "Howto update gradle wrapper" 3 months ago
gradle/wrapper v0.8.33-SNAPSHOT - upd deps, fix fatJar Main class 3 years ago
src Merge branch 'main' of ssh:// 3 weeks ago
.gitignore add syspec 2 years ago
.gitlab-ci.yml pin image: domaindrivenarchitecture/ddadevops-kotlin:4.10.7 & cleanup 5 months ago
Dockerfile update images for integration tests to ubuntu 22.04 4 weeks ago
LICENSE update 3 years ago Server: Add support for hetzner csi with encryption 1 month ago
build.gradle update Kotlin version 3 months ago bump version to: 0.35.1-SNAPSHOT 3 months ago
desktop-config-example.yaml release-0.11.10 - rename workplace to desktop 2 years ago run container tests in ci 3 years ago
gradlew initial commit 3 years ago
gradlew.bat initial commit 3 years ago
settings.gradle correct maven name to provs 3 years ago


pipeline status

DeltaChat chat over e-mail | | Website & Blog


provs provides cli-based tools for

  • provisioning a desktop (various kinds)
  • provisioning a k3s server
  • performing system checks

Tasks can be run locally or remotely.


under development - though we already set up a few IDEs and servers with provs.

Try out


  • A Java Virtual machine (JVM) is required.
  • Install jarwrapper (e.g. sudo apt install jarwrapper)
  • Then either download the binaries or build them yourself

Download the binaries

  • Download the latest provs-desktop.jar,provs-server.jar and/or provs-syspec.jar from:
    • Preferably into /usr/local/bin or any other folder where executables can be found by the system
  • Make the jar-file executable e.g. by chmod +x provs-desktop.jar

Build the binaries

Instead of downloading the binaries you can build them yourself

  • Clone this repository
  • In the repository's root folder execute: ./gradlew install. This will install the binaries in /usr/local/bin

Provision a desktop

After having installed provs-desktop.jar (see prerequisites) execute:

provs-desktop.jar <type> <target> [<options>]

type can be:

  • basic - install some basic packages)
  • office - install office software (LibreOffice), E-Mail (Thunderbird), etc
  • ide - same as office with additionally ide-software (VSCode, IntelliJ, etc)

target can be:

  • local
  • remote, e.g. - general format is: <user[:password]@host> -
    • be sure to have openssh-server installed
    • add your preferred public key to known_hosts on the target machine
    • if password is omitted, then ssh-keys will be used for authentication
    • if password is omitted but option -p is provided, then the password will be prompted interactively


  • -p for interactive password question
  • -o for only executing one action, e.g.
    • -o verify for verifying your installation
    • -o firefox to install firefox from apt on ubuntu


provs-desktop.jar basic local # installs a basic desktop on a local machine
provs-desktop.jar office -p # installs an office desktop on a remote machine, prompting for password
provs-desktop.jar ide # installs an ide on a local machine
provs-desktop.jar ide -o firefox # installs firefox on a remote machine
provs-desktop.jar ide -o verify # verifies the installation on a remote machine

Provision a k3s Server

provs-server.jar k3s local # installs a k3s server locally
provs-server.jar k3s # install remote k3s using ssh-authentication // option -p for password authentication
provs-server.jar k3s  -c path/to/k3sServerConfig.yaml -a path/to/application.yaml # as above, but define paths to your application and config yamls

For the remote server please configure a config file (default file name: server-config.yaml). It has to be in the same folder where you execute the provs-server.jar command.

fqdn: ""
  ipv4: ""   # ip address
echo: true                 # for demo reasons only - deploys an echo app 

To add a grafana agent to your k3s installation add the following to the config:

  user: "myusername"   # username for the grafana data source 
    source: "PLAIN"           # PLAIN, GOPASS or PROMPT
    parameter: "mypassword"   # the password or api key for the grafana data source user 
  cluster: "mycluster"        # a cluster name of your choice  

To provision the grafana agent only to an existing k8s system, ensure that the config (as above) is available and execute:

provs-server.jar k3s -o grafana

To add the hetzner csi driver and encrypted volumes to your k3s installation add the following to the config:

    source: "PLAIN"           # PLAIN, GOPASS or PROMPT
    parameter: "mypassword"   # the api key for the hetzner cloud
    source: "PLAIN"           # PLAIN, GOPASS or PROMPT
    parameter: "mypassword"   # the encryption passphrase for created volumes

To provision the grafana agent only to an existing k8s system, ensure that the config (as above) is available and execute:

provs-server.jar k3s -o grafana

Reprovisioning the server can easily be done using the -r or --reprovision option.

provs-server.jar k3s -c path/to/k3sServerConfig.yaml -a path/to/application.yaml -r # 

Or you can add reprovision: true to your k3sServerConfig.yaml.

Perform a system check

The default config-file for the system check is syspec-config.yaml, you can specify a different file with option -c <config-file>.

provs-syspec.jar local 
# or remote with a custom config filename
provs-syspec.jar -c my-syspec-config.yaml

Example output:

Syspec output example

Get help

To get help you can make use of the -h option:

provs-desktop.jar -h
provs-server.jar -h
provs-syspec.jar -h

Or to get help for subcommands e.g.

provs-desktop.jar ide -h
provs-server.jar k3s -h

Development & mirrors

Development happens at:

Mirrors are:

For more details about our repository model see: