> For the complete documentation index, see [llms.txt](https://dexcore.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dexcore.gitbook.io/guide/dexcore-guide-ru/nastroika/installation/config-file/gmail-setup.md).

# Настройка Gmail

Gmail — самый популярный выбор для подключения доменов к DexCore через IMAP. Следуйте этим шагам для настройки.

***

## Шаг 1: Включите IMAP в Gmail

1. Откройте [Gmail](https://mail.google.com) и войдите
2. Нажмите **⚙️ значок шестерёнки** → **Все настройки**
3. Перейдите на вкладку **Пересылка и POP/IMAP**
4. В разделе **Доступ по IMAP** выберите **Включить IMAP**
5. Нажмите **Сохранить изменения**

{% hint style="warning" %}
Если IMAP не включён, DexCore не сможет читать входящие письма с ваших доменов.
{% endhint %}

***

## Шаг 2: Создайте пароль приложения

Поскольку Gmail требует двухэтапную аутентификацию для сторонних приложений, вам нужно сгенерировать пароль приложения:

1. Перейдите в [Безопасность аккаунта Google](https://myaccount.google.com/security)
2. Убедитесь, что **Двухэтапная аутентификация** **включена**
3. Перейдите в [Пароли приложений](https://myaccount.google.com/apppasswords)
4. Выберите **Почта** как приложение и **Компьютер Windows** как устройство
5. Нажмите **Создать**
6. Скопируйте **16-символьный пароль** (например, `czbv ghdg myvc ydmu`)

{% hint style="danger" %}
Используйте этот пароль приложения в файле конфигурации — **не** обычный пароль Gmail. Обычные пароли не работают с IMAP.
{% endhint %}

***

## Шаг 3: Добавьте в файл конфигурации

Используйте следующий формат в вашем [файле конфигурации](/guide/dexcore-guide-ru/nastroika/installation/config-file.md):

```json
{
  "email": "yourgmail@gmail.com",
  "password": "czbv ghdg myvc ydmu",
  "domain": "@yourdomain.org",
  "imapHost": "imap.gmail.com",
  "imapPort": 993
}
```

| Поле         | Значение                                           |
| ------------ | -------------------------------------------------- |
| **email**    | Ваш адрес Gmail                                    |
| **password** | 16-символьный пароль приложения (не пароль Gmail!) |
| **domain**   | Ваш купленный домен с префиксом `@`                |
| **imapHost** | `imap.gmail.com`                                   |
| **imapPort** | `993`                                              |

***

## Как это работает

```
Ваш домен → Catch-all → Ящик Gmail → IMAP → Бот DexCore
```

1. Вы покупаете домен и настраиваете **catch-all** пересылку на ваш Gmail
2. Все письма, отправленные на `anything@yourdomain.com`, попадают в Gmail
3. DexCore подключается к Gmail через **IMAP** и читает эти письма
4. Бот использует эти адреса как резервные почты для аккаунтов Outlook

{% hint style="success" %}
Один аккаунт Gmail обрабатывает один домен. Если у вас несколько доменов, настройте несколько аккаунтов Gmail.
{% endhint %}