Saltar al contenido principal

El Doctor

El Overleaf Toolkit incluye un práctico script doctor que ayuda a depurar problemas. Ejecuta bin/doctor y el script mostrará información sobre tu entorno anfitrión, tu configuración y las dependencias que necesita el Toolkit. Esta salida también puede ayudarnos a diagnosticar problemas en tus instalaciones de Ayakaleaf Pro.
Los usuarios de Overleaf Pro pueden abrir un issue en GitHub.Es buena idea incluir la salida del script bin/doctor en tu mensaje.

Consultar al Doctor

Ejecuta el script doctor:
Run doctor
Verás una salida similar al siguiente ejemplo.

Información del host

La sección Host Information contiene información sobre la máquina que ejecuta el Toolkit (por ejemplo, la distribución y la versión de Linux).

Dependencias

La sección Dependencies enumera las herramientas necesarias para que el Toolkit funcione. Si una herramienta está presente, aparecerá como status: present junto con la información de su versión. Si falta, aparecerá como status: MISSING! y se añadirá una advertencia al final de la salida de doctor.
Si falta alguna dependencia, es casi seguro que el Toolkit no funcionará.

Configuración

La sección Configuration contiene información sobre los archivos del directorio config/. Para config/overleaf.rc, el doctor muestra algunos valores clave. Los archivos que falten aparecerán como status: MISSING! y se añadirá una advertencia al final de la salida de doctor.
Notas sobre el ejemplo anterior:
  • Un OVERLEAF_DATA_PATH establecido en /tmp/overleaf puede no ser una ubicación segura para datos importantes.
  • MONGO_ENABLED: false significa que el Toolkit no aprovisionará su propio MongoDB; si es necesario, asegúrate de que MONGO_URL apunta a un MongoDB gestionado externamente.
  • En el ejemplo falta config/variables.env.

Advertencias

La sección Warnings resume los problemas detectados por el script doctor. Si no hay problemas, esta sección lo indicará.

Preguntas y respuestas

Respuesta: No, los tres son informativos. bin/doctor solo imprime un informe; no detiene bin/up.
  • logged in to quay.io: false y la advertencia Server Pro enabled, but not logged in to quay.io repository: esta comprobación procede del Toolkit oficial, en el que la imagen de Server Pro está en un registro privado de quay.io. Con SERVER_PRO=true, el Toolkit descarga ghcr.io/ayaka-notes/overleaf-pro, que es pública, por lo que no es necesario iniciar sesión. Ignora esta advertencia.
  • grep: /root/.docker/config.json: No such file or directory (u otro directorio personal): la comprobación de quay.io busca quay.io en ese archivo. Docker solo lo escribe cuando tiene ajustes que guardar, por ejemplo después de docker login, por lo que falta en muchos servidores. No es necesario.
  • perl: warning: Setting locale failed: el Toolkit solo usa perl aquí, en bin/doctor, para imprimir su versión, y Perl muestra una advertencia cuando LANG o LC_ALL indican una configuración regional que no está instalada en el host. La versión se imprime igualmente. Para silenciarla, establece estas variables en una configuración regional que aparezca en locale -a, por ejemplo C.UTF-8.
Las advertencias como Docker daemon is not running, docker not found, Docker Compose not found o la falta de un archivo en config/ sí deben corregirse: el Toolkit no puede iniciarse sin ellos.
Última modificación el 2 de noviembre de 2026