> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pl/konfiguracja/overleaf-toolkit/environment-variables.md). # Zmienne środowiskowe Ta strona opisuje zmienne środowiskowe obsługiwane w `config/variables.env` pliku dla wdrożeń Toolkit. Pole `config/variables.env` plik składa się z definicji zmiennych w formie `NAME=value`; wiersze zaczynające się od `#` są traktowane jako komentarze. {% hint style="info" %} Konieczne jest ponowne utworzenie kontenerów Dockera po zmianie czegokolwiek w `overleaf.rc` lub `variables.env` uruchamiając `bin/up`. {% endhint %} ### Wszystkie wersje Te zmienne środowiskowe są zgodne z Server CE i Server Pro oraz zapewniają łatwą ścieżkę migracji między tymi dwiema wersjami on-premise. Mogą być również używane zarówno z wdrożeniami Toolkit, jak i Docker Compose. {% hint style="info" %} Wcześniej te zmienne środowiskowe miały prefiks `SHARELATEX_` zamiast `OVERLEAF_`. {% endhint %} | Nazwa | Opis | | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Miejsce, w którym Twoja instancja Overleaf jest publicznie dostępna. Jest to używane w publicznych linkach oraz podczas łączenia przez WebSockety, więc musi być skonfigurowane poprawnie! | | `OVERLEAF_ADMIN_EMAIL` | Adres e-mail, pod którym użytkownicy mogą skontaktować się z osobą zarządzającą witryną. | | `OVERLEAF_APP_NAME` | Nazwa wyświetlana podczas odwoływania się do uruchomionej aplikacji. Domyślnie: 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` i `MONGO_URL` | Adres URL bazy danych Mongo, której należy użyć. | | `OVERLEAF_REDIS_HOST` i `REDIS_HOST` | Nazwa hosta instancji Redis, której należy użyć. Oba są wymagane (zob. [uwagi do wydania](broken://pages/1e40ac48c053370983e65b8c0412d791be39bc68#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` i `REDIS_PORT` | Port instancji Redis, której należy użyć. Oba są wymagane (zob. [uwagi do wydania](broken://pages/1e40ac48c053370983e65b8c0412d791be39bc68#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` i `REDIS_PASSWORD` | Hasło używane podczas łączenia z Redisem (jeśli dotyczy). **Oba** zmienne środowiskowe muszą być ustawione. Zob. [włączenie uwierzytelniania hasłem](broken://pages/57143a49f407240f4ed7c5811892a24af7d0af02) aby uzyskać więcej informacji. | | `OVERLEAF_REDIS_TLS` |

Jeśli ustawione na true, umożliwia połączenie z instancją Redis wymagającą TLS.

Uwaga: mTLS nie jest obecnie obsługiwane.

| | `OVERLEAF_NAV_TITLE` | Ustaw tytuł karty aplikacji. | | `OVERLEAF_INVITE_TOKEN_SECRET` |

Wymagane. Losowy ciąg używany do zabezpieczania tokenów udostępniania projektów (dodane w Server Pro 6.2.0).

Minimalna liczba znaków: 16

| | `OVERLEAF_SESSION_SECRET` | Losowy ciąg używany do zabezpieczania tokenów; w przypadku równoważenia obciążenia musi być ustawiony na ten sam token we wszystkich węzłach. Jeśli działa tylko 1 instancja, użytkownik nie musi go ustawiać. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Pozwala zastąpić domyślny czas wygaśnięcia pliku cookie sesji wynoszący 5 dni. Wartość zastępcza powinna być podana w milisekundach. Przykład: aby sesja trwała 1 godzinę, ustaw `COOKIE_SESSION_LENGTH=3600000`. (Dodane w Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Jeśli nie ustawiono, domyślnie loopback. Jeśli ustawiasz ręcznie, oprócz zaufanych adresów IP musisz także uwzględnić jeden z loopback, localhost lub 127.0.0.1, który ufa instancji nginx działającej wewnątrz sharelatex kontenera.

Jeśli używasz podsieci z 172.16.0.0/12 (domyślna podsieć dla sieci Dockera) dla swojej zwykłej sieci, ustaw proszę OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ w swoim config/variables.env. \ jest IPAM -> Config -> Subnet wartość w docker inspect overleaf\_default, np. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Ma to na celu zapobieganie podszywaniu się pod X-Forwarded nagłówki.

Jeśli korzystasz z zewnętrznego proxy TLS (tj. niezarządzanego przez Overleaf Toolkit), upewnij się, że OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, np. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Jeśli ustawione na `true`, ograniczy zaproszenia do projektu do adresów e-mail odpowiadających istniejącym kontom użytkowników. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Jeśli ustawione na `true`, pozwoli nieuwierzytelnionym użytkownikom przeglądać witrynę. Domyślnie jest `false`, co oznacza, że nieuwierzytelnieni użytkownicy będą bezwarunkowo przekierowywani na stronę logowania, gdy spróbują przeglądać dowolną część witryny. Uwaga: ustawienie tej opcji w żaden sposób nie wyłącza uwierzytelniania ani zabezpieczeń. Ta opcja jest konieczna, jeśli użytkownicy mają zamiar upublicznić swoje projekty i umożliwić nieuwierzytelnionym użytkownikom ich przeglądanie. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Jeśli ustawione na `true`, pozwoli anonimowym użytkownikom przeglądać i edytować projekty udostępnione za pomocą funkcji [udostępniania linkiem](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `OVERLEAF_DISABLE_LINK_SHARING` | Wyłącza [udostępniania linkiem](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `EMAIL_CONFIRMATION_DISABLED` | Gdy ustawione na `true` , baner z prośbą o potwierdzenie adresu e-mail nie będzie wyświetlany. | | `ADDITIONAL_TEXT_EXTENSIONS` | Tablica ciągów do skonfigurowania dodatkowych rozszerzeń dla plików edytowalnych. | | `DEFAULT_LATEX_COMPILER` |

Służy do ustawienia domyślnego kompilatora używanego przez nowe projekty. (Dodane w Server Pro 6.2.0).

Opcje: pdflatex, latex, xelatex lub lualatex

| | `OVERLEAF_STATUS_PAGE_URL` | Niestandardowy adres URL strony statusu (dodane w Server Pro 3.4.0), np. `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Ustaw na `'false'` aby zapobiec inicjowaniu nowych projektów z pełną historią projektu (dodane w Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Ustaw na `'false'` aby zapobiec wyświetlaniu przez nowe projekty pełnej historii projektu zamiast starszej historii (dodane w Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Ustaw tę zmienną środowiskową na `true` aby włączyć automatyczne czyszczenie usuniętych projektów i użytkowników po 90 dniach. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Służy do modyfikacji opóźnienia wygaśnięcia usuniętych użytkowników. Konfigurowane w milisekundach.

Domyślnie: 90 dni

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Służy do modyfikacji opóźnienia wygaśnięcia usuniętych projektów. Konfigurowane w milisekundach.

Domyślnie: 90 dni

| | `MAX_UPLOAD_SIZE` |

Kontroluje maksymalny rozmiar pojedynczego przesyłanego pliku, w megabajtach. Domyślnie 50.

Uwaga: Ta zmienna to tylko surowa liczba, bez jednostki (MB) ani otoczki.

| | `COMPILE_SIZE_LIMIT` | Kontroluje maksymalny rozmiar treści żądania w bajtach. Jest to suma wszystkich rozmiarów plików dokumentów w projekcie (`main.tex`, `references.bib` (jeśli nie są połączone) itd.), którą trzeba wysłać w początkowym żądaniu kompilacji do usługi CLSI. | | `COMPILE_TIMEOUT` | Liczba sekund dozwolona na ukończenie kompilacji. Więcej informacji zob. [Aktualizacja limitu czasu kompilacji projektu](broken://pages/faf02017dd2cf478a8f77affa4ffb57a45f21068#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Konfigurowalne opóźnienie między łagodnym ponownym połączeniem edytora, opróżnianiem danych i zamknięciem kontenera, aby zmniejszyć ryzyko utraty danych. | | `SECCOMP_PROFILE` |

Ustaw tę zmienną środowiskową na ścieżkę na hoście Dockera host wskazującą na profil SECCOMP. Kopię profilu można pobrać tutaj.

Obecnie potrzebne dla wdrożeń Podman przy użyciu Sandboxed Compiles.

| | `OVERLEAF_DISABLE_CHAT` | Jeśli ustawione na `true`, wyłącza funkcję czatu w projekcie. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Gdy ustawione, może służyć do wyświetlania informacji o pomocy technicznej pod przyciskiem logowania. Tekst będzie wyświetlany na ekranie logowania i może służyć do kierowania użytkowników do wewnętrznego wsparcia lub dostarczania wskazówek dotyczących logowania, tworzenia kont itp. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Jeśli ustawione na true, pozwala, aby kontrole uruchamiania MongoDB kończyły się niepowodzeniem i nie blokowały startu wdrożenia. Może to być wymagane, jeśli używasz bazy MongoDB, w której użytkownik bazy danych nie ma roli clusterParameterReader .

Pomoc dotycząca tworzenia niestandardowej roli zob. tutaj.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Pozwala oddzielić **history-v1** punkt końcowy dla ruchu wewnętrznego (`web` usługa → `history-v1` usługa, zarówno w `sharelatex` kontenerze) jak i ruchu zewnętrznego (`git-bridge` → `history-v1`, uruchomionych w oddzielnych kontenerach). | | `OVERLEAF_MAINTENANCE_MESSAGE` i `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Służy do dostosowania tytułu i treści strony konserwacyjnej. Nie można używać z `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} Podczas korzystania z systemu logowania Overleaf (konta lokalne), a nie z opcji SSO, takiej jak LDAP, można wymusić ograniczenia haseł dla użytkowników. W przypadku kont SSO zasady haseł będą egzekwowane przez dostawcę tożsamości lub usługę katalogową, z dodatkowym wsparciem dla uwierzytelniania wieloskładnikowego. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/on-premises/pl/konfiguracja/overleaf-toolkit/environment-variables.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.