Skip to content

Installation

Wrapper Script

To easily install kissb locally in a project and fix the build system version, you can use a wrapper script in the same fashion as with a Gradle or Maven wrapper script

1
project/folder $ wget -q -O - https://github.com/richnou/kissb/raw/main/scripts/wrapper/kissbw | /bin/bash

Or just download the script and give it runtime permission

Now just call the script to run kissb:

1
project/folder $ ./kissbw

Single File Runtime

KISSB is available as a single executable containing the required TCL runtime and libraries. It is based on so called TCL Kits which we are building specifically to release KISSB.

Download the kissb runtime:

Place the downloaded file in a folder present in your PATH, for example .local/bin under linux, rename it to "kissb", then you can use the kissb command anywhere in your terminal.

Local Installation

Install TCL and requirements

Kissb requires TCL 8 to be installed on your system:

OS Installation Requirements
Ubuntu sudo apt install tcl tcllib tcl-tls tdom
Rocky Linux sudo dnf install tcl tcllib tcltls tdom Install EPEL: https://wiki.rockylinux.org/rocky/repo/#notes-on-epel

Install Using Install script

The release repository provides an installation TCL script which downloads the zip file and unpacks it to the standard installation location ~/.kissb/install/TRACK

For example for the dev track:

1
wget -qO- https://kissb.s3.de.io.cloud.ovh.net/kissb/dev/install.tcl | tclsh

Once an installation is available, the install script won't run anymore, updates should be done through the kissb update command

Install Distribution Folder

Download the latest distribution from the desired track, and unpack it for example in ~/.kissb/install/TRACK

1
2
3
4
5
mkdir -p ~/.kissb/dist && cd ~/.kissb/dist
wget https://kissb.s3.de.io.cloud.ovh.net/kissb/dev/dist-2024081702.zip
unzip dist-2024081702.zip
# Make a link as "current", so that kissb can update itself
ln -s current kissb-2024081702

Then add the bin folder to your path, or link the "kissb" script from the bin folder to a folder already on your path: 

1
2
# In .bashrc for example
export PATH="~/.kissb/dist/current/bin:$PATH"

Docker

You can use our docker image to run kissb quickly, by running the image and mapping the current folder to the container's /cwd folder. For example, setup an alias in your terminal to run the image with your user id:

alias kissb="docker run -v .:/cwd -u $(id -u ${USER}) --rm -it rleys/kissb:dev"

The following image tags are recommended: latest for the latest release, and dev for the most up to date version.

To update kissb, just pull the image on a regular basis.