# Настройка через веб-интерфейс

> Настройте провайдера, токен и репозитории через локальные формы в браузере.

Самый простой способ. Агент поднимает небольшую страницу настройки **только на
локальном адресе** (`127.0.0.1`) — она не видна из сети, и токен с неё никуда не уходит.

## Запуск

```bash
connector setup --config /etc/connector/connector.yaml
```

Откройте в браузере `http://127.0.0.1:8765`. Если настраиваете на удалённом сервере,
пробросьте порт по SSH:

```bash
ssh -L 8765:127.0.0.1:8765 user@ваш-сервер
```

_Иллюстрация: Проверка доступа и выбор репозиториев галочками — токен вводится один раз и остаётся на этой машине._

## Шаги

1. **Подключение.** Адрес relay уже задан в агенте — менять его нужно только для
   собственной (self-hosted) инсталляции. Укажите каталог состояния.
2. **Провайдер.** Выберите тип (GitLab, GitHub Enterprise, Gitea, Bitbucket Server, …),
   укажите Base URL и токен доступа. Нажмите **«Проверить доступ»** — агент сходит к
   вашему провайдеру и покажет, есть ли доступ.
3. **Репозитории.** Из полученного списка отметьте нужные репозитории галочками —
   ничего не нужно вводить руками, опечатки исключены. Нажмите **«Добавить провайдера»**.
4. **Привязка.** Вставьте одноразовый код из приложения Buff и нажмите **«Привязать»**.

Готово — агент подключён. Запустите его в постоянном режиме:

```bash
connector run --config /etc/connector/connector.yaml
```

## Изменения на лету

Чтобы менять настройки, не останавливая агент, запускайте его с админкой:

```bash
connector run --config /etc/connector/connector.yaml --admin 127.0.0.1:8765
```

Добавить репозиторий или сменить токен через ту же страницу — изменения применяются
**сразу, без перезапуска**.

Токен доступа записывается в файл с правами `600` в каталоге состояния и **никогда не
попадает в конфиг и к нам**.