5. Personalizar tu instancia

​

Personalizar tu instancia

Antes de iniciar tu instancia de Overleaf por primera vez, actualiza dos archivos de configuración con tu información personalizada:

Archivo	Lo lee	Qué se define aquí
config/overleaf.rc	los scripts del Toolkit, como bin/up	cómo se ejecutan los contenedores: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, rutas de datos
config/variables.env	la aplicación dentro del contenedor	cómo se comporta Overleaf: OVERLEAF_SITE_URL, correo electrónico, imágenes de TeX Live

1. Editar el archivo de variables

   Abre config/variables.env en tu editor de texto favorito y actualiza las variables de entorno siguientes con los valores necesarios.

2. Dirección y puerto de escucha

   De forma predeterminada, el Toolkit publica la interfaz web en 127.0.0.1:80, por lo que solo se puede abrir desde un navegador en el propio servidor. Los demás equipos obtienen un error de “conexión rechazada” o “servidor no encontrado”. Para cambiarlo, edita config/overleaf.rc:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP es la dirección IP del host a la que se vincula el contenedor, y OVERLEAF_PORT es el puerto del host. Juntos forman la asignación de puertos de Docker OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80. Elige los valores que correspondan a tu configuración:

   Configuración	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Abrir en el navegador
   Solo en esta máquina (predeterminado)	127.0.0.1	80	http://localhost
   Otros equipos de la LAN o de internet se conectan directamente	0.0.0.0, o una IP del servidor	80, o cualquier puerto libre	http://<server-ip>:<port>
   Detrás de tu propio proxy inverso (NGINX, Caddy, Cloudflare Tunnel) en el mismo host	127.0.0.1	cualquier puerto libre	la URL del proxy
   Detrás del proxy TLS del Toolkit	127.0.0.1	80	https://<your-domain>

   Si el puerto 80 ya está en uso en el host, por ejemplo por otro servidor web, establece OVERLEAF_PORT en un puerto libre como 8080. De lo contrario, bin/up falla con bind: address already in use.

   Los puertos publicados por Docker omiten los cortafuegos del host, como ufw y firewalld. Con 0.0.0.0, la instancia es accesible desde todas las redes a las que está conectado el servidor. En un servidor en la nube, también tienes que permitir el puerto en el grupo de seguridad del proveedor. Usa HTTPS antes de exponer la instancia a internet; consulta proxy TLS.

   Puedes empezar con el valor predeterminado y abrir primero la instancia en localhost. Para permitir más adelante el acceso desde otros equipos, cambia estas dos variables en config/overleaf.rc y OVERLEAF_SITE_URL en config/variables.env, y después vuelve a ejecutar bin/up para volver a crear los contenedores.

3. Variables de entorno obligatorias

   Actualiza las siguientes variables en config/variables.env:

   Nombre	Descripción	Ejemplo
   OVERLEAF_SITE_URL	Dónde está disponible públicamente tu instancia de Overleaf. Se usa en los enlaces públicos y al conectarse mediante websockets, así que ¡debe configurarse correctamente!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Esta dirección de correo electrónico se usará como dirección from de todos los correos salientes.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	La dirección de correo electrónico en la que los usuarios pueden contactar con la persona que gestiona el sitio.	[e-mail]

   OVERLEAF_SITE_URL es la dirección que los usuarios escriben en su navegador, no la dirección de escucha. Incluye el puerto cuando no sea 80 (HTTP) o 443 (HTTPS), por ejemplo http://192.168.1.20:8080. No uses http://0.0.0.0. Si OVERLEAF_SITE_URL no coincide con la dirección del navegador, el editor no consigue conectarse, y los enlaces de los correos electrónicos y los callbacks de OAuth apuntan a un lugar equivocado.

   Sin un servidor de correo, deja OVERLEAF_EMAIL_FROM_ADDRESS sin definir: así Overleaf no envía correos y puedes entregar tú mismo el enlace de activación a los nuevos usuarios; consulta las preguntas y respuestas de Acceso público.

   Establece también OVERLEAF_SESSION_SECRET en un valor generado con openssl rand -hex 32. Sin ella, cada bin/up que vuelve a crear el contenedor, y cada actualización, cierra la sesión de todos los usuarios. Consulta las preguntas y respuestas de Variables de entorno.

   Una vez que hayas actualizado estas variables de entorno, guarda y sal.

4. Configurar la compilación en sandbox

   A continuación, configura TeX Live Full para sandboxed-compiles.md. Abre config/variables.env y actualiza las siguientes variables de entorno:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
5. Iniciar tu instancia

   Para iniciar tu instancia, ejecuta:

   Start the instance

   bin/up
   

   Este comando descargará las imágenes necesarias, incluida texlive, creará los contenedores (con tus personalizaciones) e iniciará la instancia. Deberías ver la salida de los logs de los distintos contenedores Docker.

   Para volver a iniciarlos más adelante (sin adjuntarte a la salida de los logs), ejecuta:

   Start without attaching to logs

   bin/start
   

El Toolkit usa docker compose para gestionar los contenedores Docker de Overleaf. El Toolkit proporciona un conjunto de scripts que envuelven docker compose y se encargan de la mayoría de los detalles por ti.

Si todo va bien, deberías poder ver la página de inicio de sesión de tu nueva instancia de Overleaf accediendo a http://127.0.0.1/ o http://localhost/ en tu navegador. Si has cambiado OVERLEAF_LISTEN_IP u OVERLEAF_PORT, abre en su lugar la dirección de la tabla del paso Dirección y puerto de escucha, por ejemplo http://<server-ip>:8080.

Para comprobar en qué dirección y puerto se publica la interfaz web, ejecuta:

Show the published port

bin/docker-compose port sharelatex 80

La salida, por ejemplo 0.0.0.0:8080, muestra la dirección IP y el puerto del host en uso. Si muestra 127.0.0.1, la instancia solo es accesible desde el propio servidor.

Según tu configuración de red y el lugar donde esté alojada tu instancia de Overleaf, es posible que tengas que realizar cambios de configuración adicionales. Consulta los ajustes del Toolkit para obtener más detalles: toolkit-settings.md