An open API service indexing awesome lists of open source software.

https://github.com/monolithprojects/ansible-kasm_server

Kasm server installation
https://github.com/monolithprojects/ansible-kasm_server

browser desktop docker docker-compose isolation kasm

Last synced: 4 months ago
JSON representation

Kasm server installation

Awesome Lists containing this project

README

          

kasm_server
===========

# Kasm server installation
[Kasm](https://www.kasmweb.com/) is desktop and browser isolation platform.

This role will search for running Kasm docker containers. If there are not any, role will install Kasm server. Optionally it can create a persistent storage for home folder of 5 users per one server (Community Kasm version allows maximum of 5 user sessions on one server)

### Quick guide

1. register at https://www.kasmweb.com/downloads.html and download the latest community version of the Kasm Server and place it into `playbooks/files/` directory
2. define kasm servers in `inventory/hosts.ini`
3. run `ansible-galaxy install -r inventory/requirements.yml`
4. run `ansible-playbook site.yml`
5. see the Kasm credentials in the ansible output. Login into the Kasm server WebUI (output of the installation log is in `~/kasm.log`)...
---

### Playbook example:
```
---
- name: Install KASM server with persistent storage
hosts: kasm_servers
become: yes
gather_facts: no

vars:
- kasm_package: kasm_release_1.5.0.3b363e.tar.gz
- kasm_user_name: user
- display_creds: True

roles:
- monolithprojects.kasm_server
```
---

### Requirements:
- docker
- docker-compose
- swap space enabled

### License:
- MIT