KasmVNC/builder

REQIUREMENTS

Docker CE

Build a deb/rpm package

# builder/build-package <os> <os_codename>
# os_codename is what "lsb_release -c" outputs, e.g. buster, focal.
# Packages will be placed under builder/build/

builder/build-package ubuntu bionic
builder/build-package ubuntu focal
builder/build-package debian buster
builder/build-package debian bullseye
builder/build-package kali kali-rolling
builder/build-package centos core # CentOS 7
builder/build-package fedora thirtythree

Build and test a package

builder/build-and-test-deb ubuntu focal
builder/build-and-test-rpm centos core

open browser and point to https:///

3 default users are created:

• 'foo' with default password 'foobar'. It can use mouse and keyboard.
• 'foo-ro' with default password 'foobar'. It can only view.
• 'foo-owner' with default password 'foobar'. It can manage other users.

Test a package

If you want to test deb/rpm package you already built, please use this:

builder/test-deb ubuntu focal

It will install the package inside a new container.

Package development

deb/rpm package building and testing

First, a tarball is built, and then its files are copied to deb/rpm package as it is being built. Package testing stage installs the deb/rpm package in a fresh docker container and runs KasmVNC.

builder/build-tarball debian buster
builder/build-deb debian buster
builder/test-deb debian buster

build-and-test-deb is good to do the whole dev lifecycle, but to iterate quickly, you'll need to skip building tarball (which takes a long time), and just build your deb/rpm with build-deb and test with test-deb.

build-rpm and test-rpm are also available.

Ensuring packages have all dependencies they need.

If you're working on a deb/rpm package, testing that it has all necessary dependencies is done via testing in a barebones environment (read: no XFCE). In this way we can be sure that runtime dependencies aren't met accidentally by packages installed with XFCE.

builder/test-deb-barebones ubuntu focal