Please note that this is work in progress.

Run kolab with all components on a single host.

This deployment consists of a single vm, and all workloads are executed in k3s.

This is the simplest deployment mode and suitable if the workload load fits on a single system,
and downtime for maintenance or failure is acceptable.

Setup Instructions

Please also see About Kolab on Kubernetes Deployments

Executed from the control host.

• Create a directory where you intend to manage the kolab installation from
• Download the latest release here: https://mirror.apheleia-it.ch/pub/kolab-kubernetes-latest.tar.gz
• Extract the tarball: tar xf kolab-kubernetes-latest.tar.gz
• Copy deployments/k3s-single-node/inventory.example.yaml to inventory.yaml
• Adjust the new inventory.yaml, by default it will deploy everything on localhost
• Run the ansible provisioning process: ansible-playbook -v -i inventory.yaml -D deployments/k3s-single-node/ansible/playbook.yaml
• Navigate to the configured url (if dns is not already prepared via /etc/hosts entry)
• Login with the admin@YOURDOMAIN user
• Future changes can be applied via: ./kolabctl apply

Installing on a pre-existing vm (bypass vm provisioning)

It is possible to either manually provision a Virtual Machine or connect to an existing system to install Kolab. Please note that the ansible scripts assume the environment as prepared by the kvm ansible role.

Follow the above instructions with the following adjustments:

• When adjusting the new inventory.yaml:
  • Disable vm provisioning by setting ‘provision_vm: false‘
  • Set the ip to connect to your vm (only necessary if the hostname is not resolved to the correct ip on the control host):
    • Set ‘ansible_host: ip of your vm'