# Установка

> Скачайте агент (бинарь или Docker-образ), проверьте подпись и запустите.

Агент — один самодостаточный исполняемый файл. Ставьте его на любую машину в вашей
сети, у которой есть доступ к вашему git-серверу и исходящий доступ в интернет.

## Вариант 1. Бинарный файл

Скачайте файл для вашей ОС и архитектуры со страницы загрузок Buff:

- Linux — `connector-linux-amd64` / `connector-linux-arm64`
- macOS — `connector-darwin-amd64` / `connector-darwin-arm64`
- Windows — `connector-windows-amd64.exe` / `connector-windows-arm64.exe`

Проверьте контрольную сумму и подпись (артефакты подписаны cosign):

```bash
sha256sum -c SHA256SUMS --ignore-missing
cosign verify-blob --signature connector-linux-amd64.sig \
  --certificate connector-linux-amd64.pem connector-linux-amd64
chmod +x connector-linux-amd64 && sudo mv connector-linux-amd64 /usr/local/bin/connector
```

Для бинаря нужен установленный `git` (агент вызывает его для работы с репозиториями).

## Вариант 2. Docker

Образ уже содержит `git`:

```bash
docker run -d --name buff-connector \
  -v /srv/connector:/etc/connector \
  -v buff-connector-state:/var/lib/connector \
  registry.buff.systems/buff/connector:latest \
  run --config /etc/connector/connector.yaml
```

Смонтируйте том для состояния (`/var/lib/connector`) — там хранится ключ агента и
токены сессии, чтобы они пережили перезапуск контейнера.

## Дальше — настройка

- [Веб-интерфейс](/docs/connector/web-setup) — формы в браузере (рекомендуется).
- [Терминал](/docs/connector/cli-setup) — для серверов без графики.
- [YAML вручную](/docs/connector/yaml) — для автоматизации (Ansible/CI).