Zum Hauptinhalt springen
Hier haben wir Antworten auf einige häufig gestellte Fragen zu Ayakaleaf Pro zusammengestellt.

Grundlegende Fragen

Nein. Ayakaleaf Pro ist vollständig kostenlos nutzbar. Es handelt sich nicht um eine Testversion, und es wird keine Lizenz benötigt.
Ja. Ayakaleaf Pro enthält alle Funktionen von Overleaf Server Pro, einschließlich der Git-Bridge-Integration. Außerdem enthält es ausgewählte Funktionen der Overleaf-SaaS-Plattform. Wir entwickeln Ayakaleaf Pro kontinuierlich weiter und verbessern es.
Overleaf Server Pro kostet etwa $300 pro Benutzer und Jahr. Es sind mindestens 10 Lizenzen erforderlich, sodass Bereitstellungen bei rund $3.000 jährlich beginnen. Kleinere öffentliche Verträge in den USA weisen jährliche Kosten von etwa $320–$370 pro Benutzer aus. Das macht Server Pro teuer, insbesondere für kleinere Teams. Dokumentierte Käufe und Preise finden Sie unter #information-and-price-about-overleaf-server-pro.
Overleaf Server Pro wird häufig von Regierungsorganisationen eingesetzt. Diese betreiben es in privaten Netzwerken und kontrollieren den Zugriff streng. Zum Schutz sensibler Daten vermeiden die enthaltenen Funktionen den Datenaustausch mit Drittanbieterdiensten. Wenn Sie GitHub-Synchronisierung, KI oder ähnliche vernetzte Funktionen benötigen, empfiehlt Overleaf ein Abonnement seiner SaaS-Plattform.
Ayakaleaf Pro ist Open Source. Wir prüfen den Code mit Werkzeugen wie Codex Security, um seine Sicherheit und Zuverlässigkeit zu stärken. Wenn Sie keine Datensynchronisierung mit Drittanbietern aktivieren, bleiben Ihre Daten auf Ihrem Server. Ayakaleaf Pro enthält keine Telemetrie, die Ihre Daten an andere Stellen sendet.
Wir werden alles daransetzen, dieses Projekt langfristig zu pflegen.
Ayakaleaf Pro ist ein Community-Fork. Sein Code und die integrierten Funktionen stammen aus Beiträgen der Community. Es steht unter der AGPL v3. Bereitstellungen können diese Lizenz einhalten, wenn sie deren Anforderungen erfüllen.
Das Projekt hieß ursprünglich 2024 Overleaf Pro. Die Entwicklung ruhte eine Zeit lang und wurde Ende 2025 wieder aufgenommen. Im ersten Quartal 2026 benannte Overleaf sein KI-gestütztes Abonnement in Pro um. Aus der Community kam zudem der Hinweis, dass der Name Overleaf Pro Risiken in Bezug auf Markenrecht und Verwechslung bergen könnte. Nutzer könnten annehmen, das Projekt sei offiziell.Wir haben das Projekt in Ayakaleaf Pro umbenannt, um diese Verwechslung zu vermeiden. Der Name kann als „Ayaka-notes Overleaf Pro“ gelesen werden. Der Maintainer (Sie können mich ayaka nennen!) trägt seit seiner Studienzeit, vor über fünf Jahren, zur Entwicklung der Overleaf-Community bei. Diese Erfahrung untermauert unser Engagement für eine langfristige Pflege.
Seit 2026 hat die Open-Source-Community viele mit KI entwickelte LaTeX-Editoren veröffentlicht, darunter OpenAI Prism. Ayakaleaf Pro hält Ihre Daten und Dienste auf Ihrem eigenen Server. So behalten Sie die direkte Kontrolle über Ihre Bereitstellung und Ihre Daten.Viele experimentelle Community-Editoren haben keinen etablierten Plan für eine langfristige Pflege. Auch LaTeX-Kompilierungsplattformen von Drittanbietern können ihren Betrieb einstellen, wenn ihre Nutzerbasis oder ihre Einnahmen nicht ausreichen. Ayakaleaf Pro stellt den gesamten Quellcode bereit und ermöglicht Ihnen, jeden Dienst selbst zu hosten. Selbst wenn die Pflege eingestellt würde, könnte Ihr bestehender selbst gehosteter Dienst weiterlaufen.
Es wurde im Zuge der Umbenennung des Projekts (siehe F08) in ayaka-notes/ayakaleaf-pro umbenannt. Es wurde weder archiviert noch ersetzt: Es ist dasselbe Repository, und GitHub leitet alte ayaka-notes/overleaf-pro-Links und Git-Remotes auf den neuen Namen um. Das Docker-Image behält seinen Namen ghcr.io/ayaka-notes/overleaf-pro, sodass Sie config/overleaf.rc oder config/version nicht ändern müssen.

Funktionen

Die aktuelle Funktionsliste finden Sie in unserer Dokumentation. Wenn Sie sich eine bestimmte Funktion wünschen, können Sie gerne ein Issue (als Feature-Request) auf GitHub eröffnen. Wir bemühen uns, angefragte Funktionen umzusetzen, aber die Entwicklung braucht Zeit, und wir können nicht garantieren, dass jede Funktion sofort bereitgestellt wird.
Beiträge sind willkommen, eine Annahme ist jedoch nicht garantiert. Wir bewerten jeden PR anhand seiner Auswirkungen auf die zugrunde liegende Overleaf-Codebasis, seines Wartungsaufwands und des Nutzens, den er den Benutzern bringt. Wir bemühen uns, wertvolle Beiträge zu übernehmen und zu pflegen.Wir können jedoch PRs ablehnen, die übermäßig viele Änderungen einführen, aus ungeprüftem oder schlecht verstandenem KI-generiertem Code („Vibe Coding“) bestehen oder Funktionen hinzufügen, die langfristig schwer zu pflegen wären.
Wir aktualisieren die Dokumentation in der Regel, sobald wir eine neue Funktion veröffentlichen. Detaillierte Einrichtungsanweisungen und Erläuterungen zu den verfügbaren Umgebungsvariablen finden Sie in der jeweiligen Dokumentation.
Der Python Runner führt Python im Browser des Benutzers mit Pyodide 0.29.3 aus, nicht auf dem Server. Er lädt die Pakete, die Ihr Code importiert, aus den in Pyodide integrierten Paketen, etwa NumPy, pandas und Matplotlib. Mit pip installierte Pakete und andere Pakete sind nicht verfügbar. Auf dem Server muss nichts konfiguriert werden.
Nein. Die Rechtschreibprüfung hat kein Wörterbuch für Japanisch oder Chinesisch, daher sind diese Sprachen nicht in der Sprachliste der Rechtschreibprüfung enthalten. Benutzer können die Rechtschreibprüfung für ein Projekt in den Editor-Einstellungen deaktivieren.Damit ein Wort nicht mehr als falsch geschrieben markiert wird, klicken Sie mit der rechten Maustaste darauf und wählen Sie Add to dictionary. Hinzugefügte Wörter werden in Ihrem Konto gespeichert und gelten für alle Ihre Projekte. Um sie zu überprüfen oder zu entfernen, öffnen Sie die Editor-Einstellungen und dann Spelling and language → Dictionary → Edit. Durch das Hinzufügen von Wörtern wird keine neue Sprache für die Rechtschreibprüfung hinzugefügt.
Es gibt keinen Plugin-Installer. Funktionen sind Module in services/web/modules des Quellcodes, die in das Docker-Image eingebaut und mit den Einstellungen in dieser Dokumentation aktiviert werden. Um eigene hinzuzufügen, fügen Sie dem Quellcode ein Modul hinzu und bauen Sie Ihr eigenes Image.

Bereitstellung

Für die meisten Benutzer empfehlen wir die Bereitstellung mit dem Toolkit. Die Kubernetes-Unterstützung ist experimentell: Kubernetes verwenden zeigt die Manifeste, die wir mit einem oder mehreren Replikaten getestet haben, aber ein Cluster erhöht die betriebliche Komplexität und den Wartungsaufwand. Sandboxed Compiles erstellen ihre Kompilier-Container über den Docker-Socket, daher benötigt jeder Knoten, auf dem Ayakaleaf Pro läuft, Docker Engine. Konfigurationen für CRI-O, Podman oder Quadlet stellen wir nicht bereit.
Bitte lesen Sie unseren Leitfaden zur horizontalen Skalierung. Sie können mehrere Overleaf-Instanzen bereitstellen und einen Load Balancer konfigurieren, der den Datenverkehr auf sie verteilt.
Wenn Sie bereits eine Overleaf-Server-Pro-Instanz betreiben, helfen wir Ihnen gerne bei der Migration zu Ayakaleaf Pro. Bitte kontaktieren Sie uns per E-Mail oder über Issues.
Nein. Ayakaleaf Pro muss vom Stammverzeichnis einer Domain aus bereitgestellt werden. Verwenden Sie eine eigene Domain oder Subdomain, etwa https://overleaf.example.com.
Ja. Das Toolkit läuft unter Linux, macOS mit Docker Desktop und Windows mit WSL 2 und Docker Desktop. Für gemeinsam genutzte und produktive Server empfehlen wir Linux. Die Anleitungen für macOS und Windows enthalten die Einrichtung von Sandboxed Compiles.Wir stellen keine eigenständige docker-compose.yml bereit. Um die Compose-Konfiguration zu sehen, die das Toolkit verwendet, führen Sie bin/docker-compose config im Toolkit-Verzeichnis aus.
Es gibt kein Deinstallationsskript. Im Toolkit-Verzeichnis:
  1. Stoppen und entfernen Sie die Container mit bin/docker-compose down.
  2. Löschen Sie die Daten. Standardmäßig befinden sie sich im Verzeichnis data/ des Toolkit. Wenn Sie OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH oder GIT_BRIDGE_DATA_PATH in config/overleaf.rc geändert haben, löschen Sie auch diese Verzeichnisse. Dies kann nicht rückgängig gemacht werden. Erstellen Sie daher zuerst ein Backup, falls Sie die Daten noch benötigen könnten.
  3. Löschen Sie das Toolkit-Verzeichnis.
  4. Entfernen Sie die Docker-Images, die Sie mit docker images auflisten können: ghcr.io/ayaka-notes/overleaf-pro, das git-bridge-Image, mongo, redis und die TeX Live-Images.
Führen Sie Folgendes im Toolkit-Verzeichnis aus:
  • bin/stop stoppt alle Container, bin/start startet sie wieder. Die Container bleiben erhalten, sodass Benutzer angemeldet bleiben.
  • bin/up -d erstellt die Container und startet sie im Hintergrund. Führen Sie den Befehl nach Änderungen an config/variables.env, config/overleaf.rc oder config/version aus: Er erstellt die Container neu, deren Konfiguration sich geändert hat, und erst dann werden die Änderungen wirksam. bin/stop und bin/start übernehmen sie nicht.
  • bin/docker-compose restart sharelatex startet nur den Overleaf-Container neu, ohne Konfigurationsänderungen zu übernehmen.
Wenn Benutzer jedes Mal abgemeldet werden, wenn bin/up den Container neu erstellt, setzen Sie OVERLEAF_SESSION_SECRET, siehe die Fragen & Antworten unter Umgebungsvariablen.
In der Anwendung, die Sie beim Anbieter erstellen, nicht in Ayakaleaf Pro. Für keine dieser Integrationen gibt es eine Callback-Einstellung in config/variables.env: Ayakaleaf Pro bildet jede Callback-URL aus OVERLEAF_SITE_URL und sendet sie an den Anbieter, der sie ablehnt, sofern sie nicht mit der für die Anwendung registrierten übereinstimmt. Sie registrieren sie also nur beim Anbieter und setzen OVERLEAF_SITE_URL auf die Adresse, die Benutzer öffnen.Wenn Sie OVERLEAF_SITE_URL ändern, zum Beispiel auf eine neue Domain, aktualisieren Sie die URL auch bei jedem Anbieter, sonst schlägt die Verknüpfung fehl.
Standardmäßig bleibt alles auf der lokalen Festplatte des Servers, im Verzeichnis data/ des Toolkits: data/overleaf (Projektdateien, Verlauf und Kompilierausgabe), data/mongo und data/redis. Für Instanzen mit weniger als 1000 Benutzern empfehlen wir die lokale Festplatte mit regelmäßigen Backups.Das Ayakaleaf Pro-Image belegt etwa 5 GB. Die 40 GB Mindestanforderung in der Einführung gelten für Sandboxed Compiles, deren texlive-full-Images jeweils etwa 28 GB belegen. Ohne Sandboxed Compiles laufen Kompilierungen im Container sharelatex mit dem TeX Live-Basisschema plus latexmk, texcount, synctex, etoolbox und xetex, sodass viele Projekte wegen fehlender Pakete fehlschlagen. Das Verzeichnis data/ wächst dann mit Ihren Projekten und deren Verlauf; prüfen Sie es mit du -sh data/*.
Ja, vorausgesetzt, Windows bleibt wach und Docker Desktop läuft weiter. Aktivieren Sie Start Docker Desktop when you sign in to your computer, behalten Sie die restart: always-Richtlinien des Toolkits bei und deaktivieren Sie den automatischen Energiesparmodus und Ruhezustand im Netzbetrieb. Der Bildschirm darf sich ausschalten; das Verhalten beim Zuklappen des Laptops ist eine separate Einstellung. Das Schließen des Ubuntu-Terminals nach bin/up -d stoppt keine im Hintergrund laufenden Container. Das Beenden von Docker Desktop, das Pausieren seiner Engine oder wsl --shutdown unterbricht den Dienst.Der Resource Saver von Docker Desktop ist etwas anderes als der Windows-Energiesparmodus: Er greift, wenn keine Container laufen, sodass ein laufender Ayakaleaf-Stack nicht schon deshalb im Leerlauf ist, weil niemand bearbeitet. Nach einem Windows-Neustart erfordert die Starteinstellung bei der Anmeldung weiterhin, dass sich jemand anmeldet. Folgen Sie Die Instanz verfügbar halten für die Prüfungen und Wiederherstellungsschritte. Wenn die Verfügbarkeit nicht von einer interaktiven Desktop-Anmeldung abhängen darf, empfehlen wir weiterhin Linux.
Diese Anleitung verwendet das WSL 2-Backend. Es benötigt die im BIOS/UEFI aktivierte CPU-Virtualisierung, das Windows-Feature Virtual Machine Platform und eine funktionierende WSL 2-Installation. Das vollständige Hyper-V-Feature ist ein separates Docker-Desktop-Backend und keine Voraussetzung für diese WSL-Einrichtung.Prüfen Sie Task-Manager → Leistung → CPU → Virtualisierung und wsl --list --verbose in PowerShell. Fehler wie 0x80370102 können bedeuten, dass die Virtualisierung, das Windows-Feature oder der Boot-Hypervisor deaktiviert ist. Siehe die Schritte zur Fehlerbehebung bei der Windows-Installation mit den Reparaturlinks von Microsoft und Docker. Starten Sie Windows nach dem Aktivieren der erforderlichen Features neu; eine Neuinstallation von Ayakaleaf kann eine Docker-Engine, die nicht startet, nicht reparieren.

LaTeX

Wenn Sie Sandbox Compiles aktivieren, läuft die Kompilierung jedes Benutzers in einem separaten Docker-Container und ist von den Kompilierungen anderer Benutzer isoliert. Shell Escape ist für Sandbox Compiles standardmäßig aktiviert.
Wir haben unser TeX Live Full-Image für Sandbox Compiles in den letzten drei Jahren verbessert. In den meisten Fällen lassen sich Projekte, die auf overleaf.com kompilieren, auch mit Ayakaleaf Pro korrekt kompilieren. Wenn eine benötigte Schriftart nicht verfügbar ist, laden Sie diese Schriftart manuell in Ihr Projekt hoch.
Bitte laden Sie Ihr Projekt auf die offizielle Overleaf-Website hoch, aktivieren Sie die Freigabe per Nur-Lese-Link und fügen Sie den Link in ein GitHub-Issue ein.Wir untersuchen und beheben alle Fehler, die verhindern, dass ein Projekt in Ayakaleaf Pro kompiliert, wenn es auf der offiziellen Overleaf-Website erfolgreich kompiliert. Kompilierungsprobleme außerhalb dieses Rahmens sind nicht durch unseren Support abgedeckt.
Zuletzt geändert am 8. November 2026