Administrar tu instalación on-prem

El instalador deja instalada una CLI de operador, heskala, que envuelve las tareas comunes contra tu stack de Docker. No tenés que recordar comandos de docker compose ni pararte en el directorio de instalación.

Qué instala el install.sh

Además de levantar el stack, el instalador ahora:

• Verifica los prerequisitos de verdad: que exista Docker, que el daemon responda, que el plugin docker compose v2 esté presente (el viejo docker-compose con guion no sirve) y que la versión del engine sea 20.10+ (si es más vieja, avisa).
• Ofrece habilitar el arranque de Docker en el boot (en Linux con systemd corre systemctl enable docker con tu confirmación). Así, tras un reinicio, los contenedores restart: unless-stopped vuelven solos. En Docker Desktop (macOS/Windows) esto se configura desde la app — ver Arranque automático.
• Instala la CLI heskala apuntando a tu directorio de instalación (/usr/local/bin/heskala, o ~/.local/bin/heskala si no hay permisos de escritura en el primero).

La CLI se reinstala/actualiza en cada corrida del install.sh (tanto en install como en update), así que siempre queda apuntando al directorio y a la versión correctos.

Comandos

heskala <comando> [args]

Comando	Qué hace
heskala start	Levanta los servicios (backend, dashboard, frontend).
heskala stop	Detiene los servicios. No borra datos.
heskala restart [servicio]	Reinicia todo, o solo el servicio indicado (ej. heskala restart backend).
heskala status	Estado de los contenedores (equivale a docker compose ps).
heskala logs [servicio]	Sigue los logs en vivo (todos, o el servicio indicado). Ctrl+C sale.
heskala update	Baja las imágenes nuevas del tag actual y recrea, sin perder datos.
heskala backup [archivo]	Respaldo consistente del volumen de datos a un .tgz.
heskala admin-key	Imprime el admin key de esta instalación.
heskala urls	Muestra las URLs del stack (lee los puertos del .env).
heskala version	Versión de imágenes configurada en el .env.
heskala help	Ayuda con todos los comandos.

Ejemplos

# ¿Está todo arriba?
heskala status

# Ver por qué el backend no arranca
heskala logs backend

# Reiniciar solo el frontend tras un cambio de config
heskala restart frontend

# Detener el stack para mantenimiento y volver a levantarlo
heskala stop
heskala start

Backup y restore

heskala backup toma una foto consistente: detiene el backend un instante (para no copiar la base SQLite con escrituras a medias), empaqueta el volumen de datos y vuelve a levantar el backend.

# Genera heskala-data-AAAA-MM-DD.tgz en el directorio actual
heskala backup

# O a una ruta específica
heskala backup ~/backups/heskala-$(date +%F).tgz

Para restaurar ese .tgz en una instalación (por ejemplo al migrar de servidor), descomprimí el contenido dentro del volumen data con el stack detenido:

cd ~/heskala-onprem                      # tu directorio de instalación
heskala stop
# El nombre real del volumen lo ves con: docker volume ls | grep data
docker run --rm -v heskala-onprem_data:/data -v "$PWD:/backup" \
  alpine sh -c "rm -rf /data/* && tar xzf /backup/heskala-data-AAAA-MM-DD.tgz -C /data"
heskala start

⚠️ Restaurar sobrescribe los datos actuales. Hacelo solo sobre una instalación vacía o de la que ya tengas backup.

Actualizar vs. heskala update

Son dos cosas distintas:

• heskala update trae lo último del tag ya configurado en tu .env (docker compose pull && up -d). Útil para tomar un rebuild de la misma versión. No salta de versión.
• Subir de versión (ej. 0.9.34 → 0.9.35) se hace con el install.sh del bundle nuevo, que actualiza el docker-compose.yml, reinstala la CLI y conserva tus datos. Ver Actualizar a una versión nueva.

Operar varias instalaciones

La CLI viene “horneada” con el directorio de tu instalación, pero podés apuntarla a otra con la variable HESKALA_DIR:

HESKALA_DIR=/opt/heskala-cliente-b heskala status

Si heskala no se encuentra

Si el instalador la puso en ~/.local/bin y ese directorio no está en tu PATH, agregalo:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Mientras tanto, siempre podés operar con docker compose directo desde el directorio de instalación (cd ~/heskala-onprem && docker compose ps, etc.).