6. Завдання після встановлення

Створіть адміністратора, перевірте компіляцію та збереження даних і підтримуйте роботу локального екземпляра Ayakaleaf Pro на своєму Mac.

​

Створення адміністратора та першого проєкту

Відкрийте http://localhost:8080/launchpad, створіть перший обліковий запис адміністратора та увійдіть. Потім виконайте кроки з розділу 6. Завдання після встановлення посібника для Linux, використовуючи порт 8080 у прикладах URL.

​

Перевірка компіляції

Те, що сторінка входу відкривається, ще не доводить, що окремі контейнери компілятора та їхні підключені дані працюють. Створіть порожній проєкт і скомпілюйте цей main.tex:

\documentclass{article}
\begin{document}
Ayakaleaf Pro on macOS.
\end{document}

Попередній перегляд PDF має показати текст. За потреби виберіть TeX Live 2026 у налаштуваннях проєкту.

Для проєкту з китайським текстом виберіть компілятор XeLaTeX і перевірте:

\documentclass{ctexart}
\begin{document}
你好，Ayakaleaf Pro。
\end{document}

​

Перевірка збереження даних

bin/stop
bin/start

Знову відкрийте проєкт і скомпілюйте його ще раз. Ваш обліковий запис, вихідний код і файли проєкту мають залишитися на місці. Зі шляхами за замовчуванням робочі дані зберігаються в каталозі data/ Toolkit на вашому Mac.

​

Підтримання доступності екземпляра

Поки Mac перебуває в режимі сну, macOS призупиняє віртуальну машину Docker Desktop разом з усіма її контейнерами: ніхто не може відкрити екземпляр, а компіляція, що виконується, зупиняється, доки Mac не прокинеться. Важить лише режим сну системи. Дисплей може вимикатися.

Якщо екземпляром користуються інші люди або ви залишаєте тривалі завдання, тримайте Mac підключеним до живлення й забороніть автоматичний перехід у режим сну, див. Set sleep and wake settings for your Mac:

Mac	Налаштування
Настільний Mac (Mac mini, iMac, Mac Studio, Mac Pro)	System Settings → Energy: увімкніть Prevent automatic sleeping when the display is off
MacBook	System Settings → Battery → Options: увімкніть Prevent automatic sleeping on power adapter when the display is off. Це діє лише тоді, коли підключено адаптер живлення, а закриття кришки все одно переводить MacBook у режим сну

Щоб Mac не засинав лише певний час, натомість виконайте caffeinate -i у вікні Terminal. Ця команда запобігає переходу в режим сну через бездіяльність, доки ви не натиснете Ctrl+C або не закриєте вікно.

Docker Desktop — це застосунок у вашому сеансі користувача. Щоб екземпляр знову запрацював після перезавантаження, увімкніть Start Docker Desktop when you sign in to your computer у Settings → General Docker Desktop. Контейнери Toolkit використовують restart: always, тож Docker знову запускає їх, щойно Docker Desktop працює, без bin/up. Доки після перезавантаження хтось не ввійде в Mac, екземпляр залишається недоступним.

Mac, який не засинає, споживає більше енергії. Для сервісу, який має бути доступним завжди, ми рекомендуємо Linux-сервер, див. Linux.

​

Щоденне використання

Відкрийте Docker Desktop, перш ніж керувати екземпляром. У новому терміналі:

export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
cd "$HOME/ayakaleaf-toolkit"

Завдання	Команда
Запустити наявні контейнери	bin/start
Зупинити контейнери й зберегти дані	bin/stop
Застосувати зміни конфігурації	bin/up -d
Перевірити стан	bin/docker-compose ps
Переглянути журнали запуску	bin/docker-compose logs --tail=100 sharelatex
Переглянути журнали компілятора	bin/logs -f clsi

bin/start не застосовує зміни в config/: після редагування конфігурації виконайте bin/up -d. Зберігайте config/ і data/ та дотримуйтеся інструкцій з розділу Дані та резервні копії перед оновленням або перенесенням інсталяції. Копіювання файлів бази даних, поки MongoDB у них записує, не є узгодженою резервною копією.

Для локального використання залишайте екземпляр на 127.0.0.1. Щоб обслуговувати інші комп’ютери, свідомо налаштуйте адресу прослуховування, URL сайту та HTTPS, див. 5. Персоналізація вашого екземпляра посібника для Linux.

Якщо щось не працює, див. Усунення несправностей.