6. Zadania poinstalacyjne

​

Tworzenie pierwszego konta administratora

Otwórz OVERLEAF_SITE_URL z dopisanym /launchpad, na przykład http://192.0.2.10:30080/launchpad, i zarejestruj konto administratora tak jak w zadaniach poinstalacyjnych Toolkit. Następnie utwórz przykładowy projekt i go skompiluj.

Użytkowników możesz też tworzyć z wiersza poleceń:

kubectl -n overleaf exec deploy/overleaf -- bash -c \
  'cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user.mjs --admin --email=[e-mail]'

Polecenie wyświetla link do ustawienia hasła.

​

Sprawdzanie, czy kompilacje są izolowane

Skompiluj projekt, a następnie sprawdź węzeł, na którym działa pod:

kubectl -n overleaf get pod -l app=overleaf -o wide   # NODE column
# on that node:
sudo docker ps -a --filter ancestor=ghcr.io/ayaka-notes/texlive-full:2026.1
ls -ln /srv/overleaf/compiles                          # owned by uid 33 (www-data)

Każda kompilacja pojawia się jako krótkotrwały kontener o nazwie project-<project id>-<user id>-....

​

Logi i powłoka

Toolkit	Kubernetes
bin/logs web	kubectl -n overleaf exec deploy/overleaf -- tail -f /var/log/overleaf/web.log
bin/shell	kubectl -n overleaf exec -it deploy/overleaf -- bash
bin/up	kubectl apply -f ., a następnie kubectl -n overleaf rollout restart deployment/overleaf

Kontener zapisuje jeden plik logu na usługę w /var/log/overleaf/ (web.log, clsi.log, real-time.log, document-updater.log, …); kubectl logs pokazuje dane wyjściowe uruchamiania.

​

Pytania i odpowiedzi

Kompilacja kończy się niepowodzeniem lub nigdy się nie kończy.

Odpowiedź: Sprawdź na węźle, na którym działa pod, czy Docker jest uruchomiony i ma obraz wskazany w TEX_LIVE_DOCKER_IMAGE oraz czy SANDBOXED_COMPILES_HOST_DIR_* odpowiadają ścieżkom hostPath. Plik /var/log/overleaf/clsi.log w podzie wskazuje krok, który się nie powiódł.

Użytkownicy są wylogowywani po każdym ponownym uruchomieniu poda.

Odpowiedź: W Secret overleaf-secrets brakuje OVERLEAF_SESSION_SECRET, zobacz krok 2.