<!-- page:68905 -->
# Docker

Запускайте Wikilayer на комп’ютері з Docker і Compose. Публічний [репозиторій Wikilayer Docker](https://github.com/wikilayer/docker) містить опис збирання образу та `compose.yaml`. Compose запускає виконуваний файл Wikilayer і PostgreSQL 16. Вебінтерфейс і локальна адреса MCP слухають `localhost:38731`; для бази даних порт на хості не відкривається.

<!-- block:68955 -->
## Запуск через Compose

У POSIX-оболонці (на Windows — у WSL) підготуйте файли Compose:

```sh
git clone https://github.com/wikilayer/docker.git
cd docker
printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)" > .env
```

Якщо на цьому Mac ви також запускаєте Wikilayer через [Homebrew](page:68904), спершу зупиніть ту службу: обидва сервери використовують порт 38731.

```sh
brew services stop wikilayer/tap/wikilayer
```

Запустіть контейнери:

```sh
docker compose up -d
```

<!-- block:68956 -->
## Відкриття й підключення

Відкрийте локальний вебінтерфейс за адресою `http://localhost:38731`, тоді [підключіть локального агента](page:68906) і спробуйте [перші кроки](page:68885).

<!-- block:68957 -->
## Перевірка й зупинка

У клонованому каталозі `docker` перевірте, що обидві служби працюють, і виведіть версію сервера:

```sh
docker compose ps
docker compose exec -T wikilayer wikilayer version
```

Щоб зупинити контейнери, не видаляючи їхніх даних:

```sh
docker compose stop
```

Якщо на цьому Mac ви також користуєтеся сервером із Homebrew, після зупинки Docker його можна знову запустити:

```sh
brew services start wikilayer/tap/wikilayer
```

<!-- block:68958 -->
## Оновлення й збереження даних

Щоб оновитися, задайте в `.env` змінній `WIKILAYER_VERSION` значення опублікованого тегу або не задавайте її зовсім, щоб отримати `latest`, а тоді виконайте:

```sh
docker compose pull
docker compose up -d
```

Compose зберігає базу даних і завантажені файли в іменованих томах. `docker compose down` їх залишає, а `docker compose down -v` — видаляє. Перед оновленнями створюйте резервні копії обох томів, а перед зміною основної версії PostgreSQL зробіть дамп PostgreSQL.

---

## Links here

- [Homebrew](page:68904)
- [Власний сервер](page:68874)
- [Перенесення з Wikilayer.org](page:68908)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/uk/index.md)
