> ## 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. Uw instantie personaliseren

### Uw instantie personaliseren

Werk twee configuratiebestanden bij met uw eigen gegevens voordat u uw Overleaf-instantie voor de eerste keer start:

| Bestand | Gelezen door | Wat u hier instelt |
| - | - | - |
| `config/overleaf.rc` | de Toolkit-scripts, zoals `bin/up` | hoe containers draaien: `OVERLEAF_LISTEN_IP`, `OVERLEAF_PORT`, `SERVER_PRO`, datapaden |
| `config/variables.env` | de applicatie in de container | hoe Overleaf zich gedraagt: `OVERLEAF_SITE_URL`, e-mail, TeX Live-images |

**1. Het variabelenbestand bewerken**

Open `config/variables.env` in uw favoriete teksteditor en werk de onderstaande omgevingsvariabelen bij met de vereiste waarden.

**2. Luisteradres en poort**

Standaard publiceert de Toolkit de webinterface op `127.0.0.1:80`, zodat deze alleen kan worden geopend vanuit een browser op de server zelf. Andere computers krijgen een foutmelding als "connection refused" of "server not found". Om dit te wijzigen, bewerkt u `config/overleaf.rc`:

```bash title="config/overleaf.rc" theme={null}
OVERLEAF_LISTEN_IP=0.0.0.0
OVERLEAF_PORT=8080
```

`OVERLEAF_LISTEN_IP` is het IP-adres van de host waaraan de container wordt gekoppeld, en `OVERLEAF_PORT` is de poort op de host. Samen vormen ze de Docker-poorttoewijzing `OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80`. Kies de waarden die bij uw situatie passen:

| Situatie | `OVERLEAF_LISTEN_IP` | `OVERLEAF_PORT` | Openen in browser |
| - | - | - | - |
| Alleen op deze machine (standaard) | `127.0.0.1` | `80` | `http://localhost` |
| Andere computers in het LAN of op internet maken rechtstreeks verbinding | `0.0.0.0`, of één IP-adres van de server | `80`, of een willekeurige vrije poort | `http://<server-ip>:<port>` |
| Achter uw eigen reverse proxy (NGINX, Caddy, Cloudflare Tunnel) op dezelfde host | `127.0.0.1` | een willekeurige vrije poort | de URL van de proxy |
| Achter de [TLS-proxy](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/tls-proxy.md) van de Toolkit | `127.0.0.1` | `80` | `https://<your-domain>` |

Als poort `80` op de host al in gebruik is, bijvoorbeeld door een andere webserver, stel `OVERLEAF_PORT` dan in op een vrije poort zoals `8080`. Anders mislukt `bin/up` met `bind: address already in use`.

> [!WARNING]
>
> Poorten die door Docker worden gepubliceerd, omzeilen hostfirewalls zoals `ufw` en `firewalld`. Met `0.0.0.0` is de instantie bereikbaar vanuit elk netwerk waarmee de server is verbonden. Op een cloudserver moet u de poort ook toestaan in de security group van de provider. Gebruik HTTPS voordat u de instantie openstelt voor internet, zie [TLS-proxy](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/tls-proxy.md).

U kunt beginnen met de standaardwaarde en de instantie eerst op `localhost` openen. Om later toegang vanaf andere computers toe te staan, wijzigt u deze twee variabelen in `config/overleaf.rc` en `OVERLEAF_SITE_URL` in `config/variables.env`, en voert u daarna `bin/up` opnieuw uit om de containers opnieuw aan te maken.

**3. Vereiste omgevingsvariabelen**

Werk de volgende variabelen bij in `config/variables.env`:

| Naam | Beschrijving | Voorbeeld |
| - | - | - |
| `OVERLEAF_SITE_URL` | Waar uw Overleaf-instantie publiek beschikbaar is. Dit wordt gebruikt in openbare links en bij het verbinden via websockets, dus het **moet correct zijn geconfigureerd**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | Dit e-mailadres wordt gebruikt als `from`-adres voor alle uitgaande e-mails. | `no-reply@lilliput.com` |
| `OVERLEAF_ADMIN_EMAIL` | Het e-mailadres waarop gebruikers de beheerder van de site kunnen bereiken. | `it-services@lilliput.com` |

`OVERLEAF_SITE_URL` is het adres dat gebruikers in hun browser typen, niet het luisteradres. Neem de poort op als deze niet `80` (HTTP) of `443` (HTTPS) is, bijvoorbeeld `http://192.168.1.20:8080`. Gebruik geen `http://0.0.0.0`. Als `OVERLEAF_SITE_URL` niet overeenkomt met het adres in de browser, kan de editor geen verbinding maken en verwijzen links in e-mails en OAuth-callbacks naar de verkeerde plek.

Laat zonder mailserver `OVERLEAF_EMAIL_FROM_ADDRESS` leeg: Overleaf verstuurt dan geen e-mails, en je kunt nieuwe gebruikers zelf hun activatielink geven; zie de Vragen en antwoorden in [Openbare toegang](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/authentication/public-access.md).

Stel ook `OVERLEAF_SESSION_SECRET` in op een waarde die is gegenereerd met `openssl rand -hex 32`. Zonder deze variabele logt elke `bin/up` die de container opnieuw aanmaakt, en elke upgrade, alle gebruikers uit. Zie de Vragen en antwoorden in [Omgevingsvariabelen](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/environment-variables.md).

Sla het bestand op en sluit het af zodra u deze omgevingsvariabelen hebt bijgewerkt.

**4. Sandbox-compilatie instellen**

Configureer vervolgens TeX Live Full voor [sandboxed-compiles.md](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention"). Open `config/variables.env` en werk de volgende omgevingsvariabelen bij:

```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. Uw instantie starten**

Voer het volgende uit om uw instantie te starten:

```text title="Start the instance" theme={null}
bin/up
```

Deze opdracht downloadt de benodigde images, inclusief texlive, maakt de containers aan (met uw aanpassingen) en start de instantie. U zou loguitvoer van de verschillende Docker-containers moeten zien.

Om ze later opnieuw te starten (zonder aan de loguitvoer te koppelen), voert u het volgende uit:

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

> [!NOTE]
>
> De Toolkit gebruikt `docker compose` om de Docker-containers van Overleaf te beheren. De Toolkit biedt een set scripts die `docker compose` omhullen en de meeste details voor u regelen.

Als alles goed gaat, zou u de inlogpagina van uw nieuwe Overleaf-instantie moeten kunnen zien door in uw browser naar [http://127.0.0.1/](http://127.0.0.1/) of [http://localhost/](http://localhost/) te gaan. Als u `OVERLEAF_LISTEN_IP` of `OVERLEAF_PORT` hebt gewijzigd, opent u in plaats daarvan het adres uit de tabel in de stap **Luisteradres en poort**, bijvoorbeeld `http://<server-ip>:8080`.

Om te controleren op welk adres en welke poort de webinterface wordt gepubliceerd, voert u het volgende uit:

```text title="Show the published port" theme={null}
bin/docker-compose port sharelatex 80
```

De uitvoer, bijvoorbeeld `0.0.0.0:8080`, toont het IP-adres en de poort van de host die in gebruik zijn. Als `127.0.0.1` wordt getoond, is de instantie alleen bereikbaar vanaf de server zelf.

> [!WARNING]
>
> Afhankelijk van uw netwerkconfiguratie en de plek waar uw Overleaf-instantie wordt gehost, moet u mogelijk aanvullende configuratiewijzigingen doorvoeren. Zie de Toolkit-instellingen voor meer details: [toolkit-settings.md](https://ayakaleaf-pro.mintlify.site/nl/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention")


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