Instalar Kasm Workspaces en un VPS Linux (Ubuntu)

Kasm Workspaces transmite escritorios y navegadores en contenedores a su propio navegador, de modo que puede abrir un Chrome desechable o un escritorio Linux completo desde cualquier lugar. En un VPS Linux Infrawire, la edición single server es la forma más sencilla de ejecutarlo. Esta guía se centra en Ubuntu 24.04 (Ubuntu 22.04 funciona igual).

📋 Requisitos previos

Un VPS KVM nuevo con Ubuntu, acceso SSH como root y ningún otro servicio escuchando en el puerto 443. En su área de cliente encontrará la IP y la contraseña root del VPS.
Kasm recomienda al menos 2 núcleos de CPU, 4 GB de RAM y 50 GB de almacenamiento SSD para la instalación base, y cada espacio de trabajo en ejecución necesita memoria adicional. Prevea más RAM si se conectan varios usuarios a la vez.
Un dominio como kasm.example.com que apunte a VPS_IP si quiere un certificado HTTPS de confianza.

🔄 1. Preparar el servidor

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl

Kasm instala Docker por sí mismo, así que no configure antes otro motor de contenedores. Reinicie si se instaló un kernel nuevo.

⬇️ 2. Descargar la última versión

El número de versión cambia con frecuencia, así que no lo copie de un tutorial antiguo. Abra la página oficial de descargas (https://kasmweb.com/downloads) o la guía de instalación single server (https://kasmweb.com/docs/latest/install/single_server_install.html), copie el enlace del archivo de la versión actual para el instalador single server y úselo en lugar de RELEASE_URL a continuación.

Bash
1cd /tmp
2curl -O RELEASE_URL
3tar -xf kasm_release_*.tar.gz

El archivo se extrae en un directorio kasm_release que contiene install.sh.

⚙️ 3. Instalar con suficiente swap

Los espacios de trabajo consumen mucha memoria, y el swap protege al servidor de cierres bruscos por falta de memoria. El instalador puede crear un archivo de swap con la opción --swap-size (en MB):

Bash
1sudo bash /tmp/kasm_release/install.sh --swap-size 4096

Si el puerto 443 ya está ocupado, añada -L 8443 para servir la interfaz web en el 8443. La instalación descarga varias imágenes de Docker y tarda de 10 a 20 minutos. Al final, el script muestra las contraseñas generadas para las cuentas por defecto admin@kasm.local y user@kasm.local. Guárdelas de inmediato: solo se muestran una vez.

🌐 4. Abrir la consola web

Vaya a https://VPS_IP (o https://VPS_IP:8443 si cambió el puerto). Acepte por ahora la advertencia del certificado autofirmado. Inicie sesión como admin@kasm.local para acceder al área de administración y cambie las contraseñas generadas desde el menú de usuario.

Si usa un cortafuegos, permita el puerto web:

Bash
1ufw allow 22/tcp
2ufw allow 443/tcp
3ufw enable

Permita SSH antes de activar UFW para no quedarse fuera.

🔒 5. Añadir un certificado Let's Encrypt

Kasm sirve su propio certificado mediante un proxy Nginx interno. Solicite un certificado con Certbot en modo standalone, que necesita el puerto 80 libre (Kasm no lo usa), y cópielo donde Kasm lo espera:

Bash
1apt -y install certbot
2certbot certonly --standalone -d kasm.example.com
3cp /etc/letsencrypt/live/kasm.example.com/fullchain.pem /opt/kasm/current/certs/kasm_nginx.crt
4cp /etc/letsencrypt/live/kasm.example.com/privkey.pem /opt/kasm/current/certs/kasm_nginx.key
5/opt/kasm/bin/stop
6/opt/kasm/bin/start

Los certificados duran 90 días, así que repita la copia y el reinicio tras cada renovación, por ejemplo con un hook de despliegue de Certbot en /etc/letsencrypt/renewal-hooks/deploy/.

🚀 6. Lanzar un navegador aislado

Inicie sesión como usuario normal (user@kasm.local) y la página Workspaces mostrará las imágenes disponibles. Si la lista está vacía, entre como admin, abra Workspaces > Registry e instale las imágenes que quiera, como Chrome, Firefox o un escritorio Ubuntu. Después haga clic en un espacio de trabajo para iniciarlo: una nueva pestaña muestra un escritorio completo o un navegador transmitido hacia usted, con controles de portapapeles y transferencia de archivos en el panel lateral. Al cerrar la sesión, el contenedor se destruye.

✅ 7. Verificar

Bash
1docker ps --format '{{.Names}}: {{.Status}}'
2ss -tlnp | grep -E ':(443|8443)\b'
3free -h

Debería ver los contenedores kasm_* en ejecución, el puerto web en escucha y swap presente en la salida de free -h.

🧰 Solución de problemas

El instalador se detiene con un error de memoria o de disco: revise free -h y df -h. Añada swap con --swap-size, libere espacio en disco y vuelva a ejecutar el instalador.
Un espacio de trabajo se queda en la pantalla de carga: probablemente falta RAM al servidor o la imagen no se ha descargado por completo. Revise docker ps -a y los registros en /opt/kasm/current/log/, y cierre otras sesiones.
El navegador avisa del certificado: los archivos de /opt/kasm/current/certs/ no se reemplazaron o los servicios no se reiniciaron. Repita el paso 5 y use el nombre de dominio, no la IP, en la barra de direcciones.
Contraseña de admin perdida: restablézcala desde el área de administración con otra cuenta de administrador, o reinstale en un VPS limpio si no queda ningún administrador.

🎉 Kasm Workspaces está en marcha: lance navegadores y escritorios a demanda, aislados de forma segura de su propio equipo.