# Если что-то пошло не так (/ru/docs/mail/troubleshooting)

Начните с симптома, выполните проверку, затем повторите команду. Сохраните код ошибки и имя профиля для обращения в
поддержку.

| Симптом | Что делать |
| --- | --- |
| Не уверены, что настроено | Выполните `mail doctor`. Он не читает связку ключей и не использует сеть. |
| `mail` не найден | Откройте новый терминал и проверьте, что глобальная папка npm есть в `PATH`. |
| "name a profile" | Поставьте профиль первым, как в `mail ya folders list`, или задайте `MAIL_PROFILE`. |
| Файл настроек не читается | `doctor` перечисляет все проблемы файла в `config.issues`. Выполните `config unset`, который он указывает для каждой, или исправьте файл вручную. |
| `doctor` показывает `files.problems` | Другие пользователи компьютера могут читать `config.json` или входить в его папку. Выполните каждый `chmod`, который `doctor` печатает после "to make it private:". Сам `doctor` права на файлы никогда не меняет. |
| "no app password for profile" | Выполните `mail <profile> session start` или задайте `MAIL_PASSWORD` для одного запуска. |
| "the mail server refused the login" | Пароль приложения неверен, либо IMAP и пароли приложений выключены. Шаги для каждого провайдера описаны в [подготовке почтового ящика](/llms.mdx/docs/ru/mail/providers/content.md). Яндексу после создания нового пароля приложения нужно ещё 2–3 часа. Затем снова `session start`. |
| `rate_limited` | Две причины. **Сервер ограничивает аккаунт:** команда завершается ошибкой «the mail server is limiting this account»; подождите и выполните её снова. **`sync` израсходовал собственный бюджет запросов:** `sync` не завершается ошибкой. Он отвечает `state: partial` с `stopped: "requests"`, а в `meta.issues` есть `rate_limited` с причиной `budget.requests`; выполните `sync` снова, чтобы продолжить, или увеличьте `--max-pages`. В обоих случаях уже сохранённая почта пропускается. |
| "could not reach the OS keyring" | Хранилище ключей заблокировано или не запущена служба секретов. Пароль сохранён вместо этого в закрытом файле (`credential_storage: "file"`). Разблокируйте связку ключей и снова выполните `session start`, чтобы вернуть его туда. |
| Запись отклонена | Её останавливают разрешения профиля или `MAIL_READ_ONLY`; см. [настройки](/llms.mdx/docs/ru/mail/configuration/content.md#permissions). |

Никогда не вставляйте токен, пароль или личное содержимое в обращение в поддержку.