> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`:

```bash title="config/overleaf.rc" theme={null}
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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/tls-proxy.md) 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`.

> [!WARNING]
>
> 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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/tls-proxy.md).

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. | `no-reply@lilliput.com` |
| `OVERLEAF_ADMIN_EMAIL` | La dirección de correo electrónico en la que los usuarios pueden contactar con la persona que gestiona el sitio. | `it-services@lilliput.com` |

`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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/authentication/public-access.md).

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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/environment-variables.md).

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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention"). Abre `config/variables.env` y actualiza las siguientes variables de entorno:

```dotenv title="config/variables.env" wrap theme={null}
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:

```text title="Start the instance" theme={null}
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:

```text title="Start without attaching to logs" theme={null}
bin/start
```

> [!NOTE]
>
> 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/](http://127.0.0.1/) o [http://localhost/](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:

```text title="Show the published port" theme={null}
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.

> [!WARNING]
>
> 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](https://ayakaleaf-pro.mintlify.site/es/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention")


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.