6. Tareas posteriores a la instalación

​

Crear tu primera cuenta de administrador

Abre OVERLEAF_SITE_URL seguido de /launchpad, por ejemplo http://192.0.2.10:30080/launchpad, y registra la cuenta de administrador como en las tareas posteriores a la instalación del Toolkit. Después, crea un proyecto de ejemplo y compílalo.

También puedes crear usuarios desde la línea de comandos:

kubectl -n overleaf exec deploy/overleaf -- bash -c \
  'cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user.mjs --admin --email=[e-mail]'

Muestra un enlace que permite establecer la contraseña.

​

Comprobar que las compilaciones están aisladas

Compila un proyecto y, después, examina el nodo que ejecuta el pod:

kubectl -n overleaf get pod -l app=overleaf -o wide   # NODE column
# on that node:
sudo docker ps -a --filter ancestor=ghcr.io/ayaka-notes/texlive-full:2026.1
ls -ln /srv/overleaf/compiles                          # owned by uid 33 (www-data)

Cada compilación aparece como un contenedor de corta duración llamado project-<project id>-<user id>-....

​

Registros y una shell

Toolkit	Kubernetes
bin/logs web	kubectl -n overleaf exec deploy/overleaf -- tail -f /var/log/overleaf/web.log
bin/shell	kubectl -n overleaf exec -it deploy/overleaf -- bash
bin/up	kubectl apply -f . y después kubectl -n overleaf rollout restart deployment/overleaf

El contenedor escribe un archivo de registro por servicio en /var/log/overleaf/ (web.log, clsi.log, real-time.log, document-updater.log, …); kubectl logs muestra la salida de arranque.

​

Preguntas y respuestas

La compilación falla o nunca termina.

Respuesta: Comprueba, en el nodo que ejecuta el pod, que Docker está en ejecución y tiene la imagen indicada en TEX_LIVE_DOCKER_IMAGE, y que SANDBOXED_COMPILES_HOST_DIR_* coincide con las rutas hostPath. /var/log/overleaf/clsi.log en el pod indica el paso que falla.

Los usuarios pierden la sesión tras cada reinicio del pod.

Respuesta: Falta OVERLEAF_SESSION_SECRET en el Secret overleaf-secrets; consulta el paso 2.