Skip to main content

Kasm Workspaces (Single Server)

Kasm Workspaces ermöglicht es, Desktop-Umgebungen und Browser isoliert in Docker-Containern zu streamen. In diesem Guide installieren wir alle Dienste auf einem einzigen Server.

1. Voraussetzungen & Firewall​

Bevor du startest, müssen folgende Ports in deiner Firewall (oder bei deinem Cloud-Anbieter) freigegeben sein:

PortProtokollZweck
443TCPWeb-Oberfläche (HTTPS)
3389TCPOptional: RDP Gateway Zugriff

2. Arbeiten im Terminal (Tipps)​

In dieser Anleitung nutzen wir einige Standard-Tools:

  • cd /tmp: Wir wechseln in das temporäre Verzeichnis, da wir die Installationsdateien nach dem Setup nicht mehr brauchen.
  • curl -O: Lädt die Datei herunter und behält den ursprünglichen Dateinamen bei.
  • tar -xf: Entpackt das Archiv (x für extract, f für file).
  • sudo: Da Kasm tief in das System eingreift und Docker-Netzwerke erstellt, muss das Skript mit Root-Rechten ausgeführt werden.

3. Installation​

Standard Installation (Online)​

Kopiere diese Befehle nacheinander in dein Terminal:

# In das Temp-Verzeichnis wechseln
cd /tmp

# Installer herunterladen
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz)

# Archiv entpacken
tar -xf kasm_release_1.17.0.7f020d.tar.gz

# Installationsskript starten
sudo bash kasm_release/install.sh

4. Offline Installation (Alternative)​

Falls dein Server keine direkte Internetverbindung hat oder du Images lokal vorhalten willst, müssen die Service- und Workspace-Images separat geladen werden.

Beispiel für x86-64 (AMD64):

cd /tmp
# Alle benötigten Pakete laden
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz)

tar -xf kasm_release_1.17.0.7f020d.tar.gz

# Installation mit Verweis auf die lokalen Images
sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz --offline-service /tmp/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz --offline-network-plugin /tmp/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz

5. Ersteinrichtung & Login​

Sobald das Skript fertig ist, werden dir im Terminal Benutzernamen und Passwörter angezeigt.

WICHTIG: Kopiere diese Zugangsdaten sofort und speichere sie sicher ab! Sie werden zufällig generiert.

Passwort beim Installieren festlegen?​

Du kannst das Passwort auch direkt beim Start des Skripts vorgeben: sudo bash kasm_release/install.sh --admin-password deinPasswort123

6. Fehlerbehebung​

Wenn die Installation fehlschlägt, stelle sicher, dass:

  1. Genug Speicherplatz in /tmp und /var/lib/docker vorhanden ist.
  2. Keine anderen Dienste die Ports 443 belegen (z.B. ein bereits laufender Apache oder Nginx ohne Proxy-Konfiguration).





```python?code_reference&code_event_index=1
content = """# Setup Guide: Kasm Workspaces (Single Server)

Kasm Workspaces ermöglicht es, Desktop-Umgebungen und Browser isoliert in Docker-Containern zu streamen. In diesem Guide installieren wir alle Dienste auf einem einzigen Server.

---

## 1. Architektur & Firewall
In dieser Konfiguration kommunizieren alle Dienste über interne Docker-Netzwerke. Nur die Web-Anwendung muss nach außen erreichbar sein.

| Port | Protokoll | Zweck |
| :--- | :--- | :--- |
| **443** | TCP | Web Application (HTTPS) |
| **3389** | TCP | Optional: RDP Gateway Zugriff |

---

## 2. Arbeiten im Terminal (Tipps)

In dieser Anleitung nutzen wir einige Standard-Tools:
* **cd /tmp**: Wir wechseln in das temporäre Verzeichnis, da wir die Installationsdateien nach dem Setup nicht mehr brauchen.
* **curl -O**: Lädt eine Datei herunter. Das große 'O' sorgt dafür, dass die Datei unter ihrem Namen gespeichert wird.
* **tar -xf**: Entpackt das Archiv ('x' für extract).
* **sudo**: Da Kasm tief in das System eingreift, Docker-Container erstellt und Netzwerke konfiguriert, ist 'sudo' für das Installationsskript zwingend erforderlich.

---

## 3. Installation (Standard Online)

Stelle sicher, dass du eine Internetverbindung hast. Kopiere diese Befehle nacheinander:

```bash
# In das Temp-Verzeichnis wechseln
cd /tmp

# Installer-Paket herunterladen
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz)

# Archiv entpacken
tar -xf kasm_release_1.17.0.7f020d.tar.gz

# Installationsskript mit sudo ausführen
sudo bash kasm_release/install.sh

4. Offline Installation (Alternative)​

Falls dein Server in einem abgeschotteten Netzwerk steht, musst du die Images separat laden.

Beispiel für x86-64 (AMD64):

cd /tmp
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz)
curl -O [https://kasm-static-content.s3.amazonaws.com/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz](https://kasm-static-content.s3.amazonaws.com/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz)

tar -xf kasm_release_1.17.0.7f020d.tar.gz

sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz --offline-service /tmp/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz --offline-network-plugin /tmp/kasm_release_plugin_images_amd64_1.17.0.7f020d.tar.gz

5. Ersteinrichtung & Login​

Sobald das Skript fertig ist, werden dir im Terminal zufällig generierte Passwörter angezeigt.

WICHTIG: Scrolle im Terminal nach oben und kopiere die Passwörter sofort!

Eigenes Passwort vergeben?​

Du kannst Passwörter auch direkt beim Installieren setzen: 'sudo bash kasm_release/install.sh --admin-password MeinSicheresPasswort'

6. Fehlerbehebung​

  • Port 443 belegt: Prüfe mit 'sudo netstat -tulpn | grep 443', ob ein anderer Webserver (wie Apache oder Nginx) läuft.
  • Logs prüfen: Kasm nutzt Docker. Du kannst den Status der Container mit 'sudo docker ps' prüfen.