Naar hoofdinhoud gaan
Hier hebben we antwoorden verzameld op enkele veelgestelde vragen over Ayakaleaf Pro.

Basisvragen

Nee. Ayakaleaf Pro is volledig gratis te gebruiken. Het is geen proefversie en er is geen licentie voor nodig.
Ja. Ayakaleaf Pro bevat alle functies van Overleaf Server Pro, inclusief de Git-Bridge-integratie. Het bevat ook een selectie van functies van het Overleaf SaaS-platform. We blijven Ayakaleaf Pro verder ontwikkelen en verbeteren.
Overleaf Server Pro kost ongeveer $300 per gebruiker per jaar. Er zijn minimaal 10 licenties vereist, dus implementaties beginnen bij ongeveer $3.000 per jaar. Kleinere openbare Amerikaanse contracten laten jaarlijkse kosten zien van ongeveer $320–$370 per gebruiker. Dat maakt Server Pro duur, vooral voor kleinere teams. Zie #information-and-price-about-overleaf-server-pro voor gedocumenteerde aankopen en prijzen.
Overleaf Server Pro wordt vaak gebruikt door overheidsorganisaties. Zij implementeren het op privénetwerken en beheren de toegang strikt. Om gevoelige gegevens te beschermen, wisselen de meegeleverde functies geen gegevens uit met diensten van derden. Als je GitHub Sync, AI of vergelijkbare verbonden functies nodig hebt, raadt Overleaf een abonnement op het SaaS-platform aan.
Ayakaleaf Pro is open source. We controleren de code met tools zoals Codex Security om de beveiliging en betrouwbaarheid te versterken. Als je geen gegevenssynchronisatie met derden inschakelt, blijven je gegevens op je eigen server. Ayakaleaf Pro bevat geen telemetrie die je gegevens naar elders verstuurt.
We zullen er alles aan doen om dit project op lange termijn te onderhouden.
Ayakaleaf Pro is een community-fork. De code en geïntegreerde functies komen voort uit bijdragen van de community. Het valt onder de AGPL v3-licentie. Implementaties voldoen aan deze licentie wanneer ze aan de bijbehorende vereisten voldoen.
Het project heette oorspronkelijk Overleaf Pro in 2024. De ontwikkeling lag een tijd stil en werd eind 2025 hervat. In het eerste kwartaal van 2026 hernoemde Overleaf zijn abonnement met AI-functies naar Pro. Feedback uit de community wees er ook op dat de naam Overleaf Pro risico’s op het gebied van merkrecht en imitatie met zich mee kon brengen. Gebruikers zouden kunnen denken dat het project officieel was.We hebben het project hernoemd naar Ayakaleaf Pro om die verwarring te voorkomen. De naam kan worden gelezen als “Ayaka-notes Overleaf Pro”. De maintainer (je mag me ayaka noemen!) draagt al sinds zijn studententijd, meer dan vijf jaar geleden, bij aan de ontwikkeling van de Overleaf-community. Deze ervaring onderbouwt onze toezegging om het project op lange termijn te onderhouden.
Sinds 2026 heeft de opensourcecommunity veel met AI gebouwde LaTeX-editors uitgebracht, waaronder OpenAI Prism. Ayakaleaf Pro houdt je gegevens en services op je eigen server. Zo heb je directe controle over je implementatie en je gegevens.Veel experimentele community-editors hebben geen vastgesteld plan voor onderhoud op lange termijn. LaTeX-compilatieplatforms van derden kunnen ook stoppen wanneer hun gebruikersbestand of inkomsten onvoldoende zijn. Ayakaleaf Pro levert alle broncode en laat je elke service zelf hosten. Zelfs als het onderhoud zou stoppen, kan je bestaande zelfgehoste service blijven draaien.
Deze is bij de hernoeming van het project hernoemd naar ayaka-notes/ayakaleaf-pro (zie V08). Ze is niet gearchiveerd of vervangen: het is dezelfde repository, en GitHub stuurt oude links naar ayaka-notes/overleaf-pro en Git-remotes door naar de nieuwe naam. De Docker-image behoudt zijn naam, ghcr.io/ayaka-notes/overleaf-pro, dus je hoeft config/overleaf.rc of config/version niet te wijzigen.

Functies

Raadpleeg onze documentatie voor de actuele lijst met functies. Als er een functie is die je graag toegevoegd zou zien, open dan gerust een issue (voor een functieverzoek) op GitHub. We doen ons best om aangevraagde functies te implementeren, maar ontwikkeling kost tijd en we kunnen niet garanderen dat elke functie meteen wordt opgeleverd.
Bijdragen zijn welkom, maar acceptatie is niet gegarandeerd. We beoordelen elke PR op basis van de impact op de onderliggende Overleaf-codebase, de onderhoudslast en de waarde die hij gebruikers biedt. We doen ons best om waardevolle bijdragen te mergen en te onderhouden.We kunnen echter PR’s afwijzen die buitensporig veel wijzigingen introduceren, bestaan uit niet-gereviewde of slecht begrepen door AI gegenereerde code (“vibe coding”), of functies toevoegen die op termijn moeilijk te onderhouden zijn.
Over het algemeen werken we de documentatie bij wanneer we een nieuwe functie uitbrengen. Raadpleeg de betreffende documentatie voor gedetailleerde installatie-instructies en uitleg over de beschikbare omgevingsvariabelen.
De Python Runner voert Python uit in de browser van de gebruiker met Pyodide 0.29.3, niet op de server. Deze laadt de pakketten die je code importeert uit de pakketten die in Pyodide zijn ingebouwd, zoals NumPy, pandas en Matplotlib. Pakketten die met pip zijn geïnstalleerd en andere pakketten zijn niet beschikbaar. Er hoeft niets op de server te worden geconfigureerd.
Nee. De spellingcontrole heeft geen woordenboek voor Japans of Chinees, dus deze talen staan niet in de lijst met talen voor de spellingcontrole. Gebruikers kunnen de spellingcontrole voor een project uitschakelen in de editorinstellingen.Om te voorkomen dat een woord als verkeerd gespeld wordt gemarkeerd, klik je er met de rechtermuisknop op en kies je Add to dictionary. Toegevoegde woorden worden in je account opgeslagen en gelden voor al je projecten. Om ze te bekijken of te verwijderen, open je de editorinstellingen en daarna Spelling and language → Dictionary → Edit. Het toevoegen van woorden voegt geen nieuwe taal voor de spellingcontrole toe.
Er is geen installatieprogramma voor plug-ins. Functies zijn modules in services/web/modules van de broncode, worden in de Docker-image ingebouwd en worden ingeschakeld met de instellingen in deze documentatie. Om je eigen functie toe te voegen, voeg je een module toe aan de broncode en bouw je je eigen image.

Implementatie

Voor de meeste gebruikers raden we aan te implementeren met de Toolkit. Ondersteuning voor Kubernetes is experimenteel: Kubernetes gebruiken toont de manifests die we met één of meerdere replica’s hebben getest, maar een cluster voegt operationele complexiteit en onderhoud toe. Sandboxed Compiles maken hun compilatiecontainers aan via de Docker-socket, dus elke node die Ayakaleaf Pro draait, heeft Docker Engine nodig. We bieden geen configuraties voor CRI-O, Podman of Quadlet.
Raadpleeg onze handleiding voor horizontaal schalen. Je kunt meerdere Overleaf-instanties implementeren en een load balancer configureren om het verkeer over die instanties te verdelen.
Als je een bestaande Overleaf Server Pro-instantie hebt, helpen we je graag bij de migratie naar Ayakaleaf Pro. Neem contact op via e-mail of issues.
Nee. Ayakaleaf Pro moet vanaf de root van een domein worden aangeboden. Gebruik een eigen domein of subdomein, zoals https://overleaf.example.com.
Ja. De Toolkit draait op Linux, macOS met Docker Desktop en Windows met WSL 2 en Docker Desktop. We raden Linux aan voor gedeelde servers en productieservers. De handleidingen voor macOS en Windows bevatten de installatie van Sandboxed Compiles.We leveren geen losse docker-compose.yml. Om de Compose-configuratie te zien die de Toolkit gebruikt, voer je bin/docker-compose config uit in de Toolkit-map.
Er is geen script om de installatie ongedaan te maken. In de Toolkit-map:
  1. Stop en verwijder de containers met bin/docker-compose down.
  2. Verwijder de gegevens. Standaard staan die in de map data/ van de Toolkit. Als je OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH of GIT_BRIDGE_DATA_PATH in config/overleaf.rc hebt gewijzigd, verwijder die mappen dan ook. Dit kan niet ongedaan worden gemaakt, dus maak eerst een back-up als je de gegevens mogelijk nog nodig hebt.
  3. Verwijder de Toolkit-map.
  4. Verwijder de Docker-images, die je kunt weergeven met docker images: ghcr.io/ayaka-notes/overleaf-pro, het git-bridge-image, mongo, redis en de TeX Live-images.
Voer deze opdrachten uit in de Toolkit-map:
  • bin/stop stopt alle containers, bin/start start ze weer. De containers blijven behouden, dus gebruikers blijven ingelogd.
  • bin/up -d maakt de containers aan en start ze op de achtergrond. Voer dit uit na het wijzigen van config/variables.env, config/overleaf.rc of config/version: het maakt de containers waarvan de configuratie is gewijzigd opnieuw aan, en pas dan worden de wijzigingen van kracht. bin/stop en bin/start passen ze niet toe.
  • bin/docker-compose restart sharelatex herstart alleen de Overleaf-container, zonder configuratiewijzigingen toe te passen.
Als gebruikers telkens worden uitgelogd wanneer bin/up de container opnieuw aanmaakt, stel dan OVERLEAF_SESSION_SECRET in; zie de Vragen en antwoorden in Omgevingsvariabelen.
In de applicatie die je bij de provider aanmaakt, niet in Ayakaleaf Pro. Er is voor geen van deze integraties een callback-instelling in config/variables.env: Ayakaleaf Pro stelt elke callback-URL samen uit OVERLEAF_SITE_URL en stuurt deze naar de provider, die hem weigert tenzij hij overeenkomt met de URL die voor de applicatie is geregistreerd. Je registreert hem dus alleen bij de provider en stelt OVERLEAF_SITE_URL in op het adres dat gebruikers openen.Als je OVERLEAF_SITE_URL wijzigt, bijvoorbeeld naar een nieuw domein, werk de URL dan ook bij elke provider bij, anders mislukt het koppelen.
Standaard blijft alles op de lokale schijf van de server, in de map data/ van de Toolkit: data/overleaf (projectbestanden, geschiedenis en compilatie-uitvoer), data/mongo en data/redis. Voor instanties met minder dan 1000 gebruikers raden we een lokale schijf met regelmatige back-ups aan.De Ayakaleaf Pro-image neemt ongeveer 5 GB in beslag. Het minimum van 40 GB in de Inleiding is bedoeld voor Sandboxed Compiles, waarvan de texlive-full-images elk ongeveer 28 GB innemen. Zonder Sandboxed Compiles draaien compilaties in de container sharelatex met het basisschema van TeX Live plus latexmk, texcount, synctex, etoolbox en xetex, waardoor veel projecten mislukken door ontbrekende pakketten. De map data/ groeit daarna mee met je projecten en hun geschiedenis; controleer dit met du -sh data/*.
Ja, mits Windows wakker blijft en Docker Desktop blijft draaien. Schakel Start Docker Desktop when you sign in to your computer in, behoud de restart: always-beleidsregels van de Toolkit en schakel automatische slaapstand en sluimerstand uit wanneer de computer op netstroom werkt. Het scherm mag uitgaan; het gedrag bij het sluiten van een laptopdeksel is een aparte instelling. Het sluiten van de Ubuntu-terminal na bin/up -d stopt losgekoppelde (detached) containers niet. Docker Desktop afsluiten, de engine ervan pauzeren of wsl --shutdown uitvoeren onderbreekt de service.Resource Saver van Docker Desktop is iets anders dan de Windows-slaapstand: het is van toepassing wanneer er geen containers draaien, dus een draaiende Ayakaleaf-stack is niet inactief alleen omdat niemand aan het bewerken is. Na een herstart van Windows moet iemand zich nog steeds aanmelden voordat de opstartinstelling bij aanmelding werkt. Volg De instantie beschikbaar houden voor de controles en herstelstappen. Linux blijft onze aanbeveling wanneer de beschikbaarheid niet afhankelijk mag zijn van een interactieve aanmelding op het bureaublad.
Deze handleiding gebruikt de WSL 2-backend. Daarvoor moet CPU-virtualisatie zijn ingeschakeld in BIOS/UEFI, moet de Windows-functie Virtual Machine Platform aanstaan en moet WSL 2 correct geïnstalleerd zijn. De volledige Hyper-V-functie is een aparte backend van Docker Desktop en is geen vereiste voor deze WSL-installatie.Controleer Taakbeheer → Prestaties → CPU → Virtualisatie en voer wsl --list --verbose uit in PowerShell. Fouten zoals 0x80370102 kunnen betekenen dat virtualisatie, de Windows-functie of de opstart-hypervisor is uitgeschakeld. Zie de stappen voor probleemoplossing bij de Windows-installatie, met de herstellinks van Microsoft en Docker. Herstart Windows nadat je de vereiste functies hebt ingeschakeld; Ayakaleaf opnieuw installeren lost een Docker-engine die niet start niet op.

LaTeX

Wanneer je Sandbox Compiles inschakelt, wordt de compilatie van elke gebruiker in een afzonderlijke Docker-container uitgevoerd, geïsoleerd van de compilaties van andere gebruikers. Shell Escape is standaard ingeschakeld voor Sandbox Compiles.
We hebben onze TeX Live Full-image voor Sandbox Compiles de afgelopen drie jaar verbeterd. In de meeste gevallen compileren projecten die op overleaf.com compileren ook correct met Ayakaleaf Pro. Als een benodigd lettertype niet beschikbaar is, upload dat lettertype dan handmatig naar je project.
Upload je project naar de officiële Overleaf-website, schakel delen via een alleen-lezen-link in en voeg de link toe aan een GitHub-issue.We onderzoeken en verhelpen bugs die verhinderen dat een project in Ayakaleaf Pro compileert, wanneer het wel succesvol compileert op de officiële Overleaf-website. Compilatieproblemen buiten dit bereik vallen niet onder onze ondersteuning.
Laatst gewijzigd op 8 november 2026