Certbot: The requested nginx plugin does not appear to be installed

Что сделать прямо сейчас

1. Узнайте, откуда установлен Certbot, — шаг 1.
2. Поставьте плагин nginx — шаг 2.
3. Повторите команду — шаг 3.

Все команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

Что значит это сообщение

Saving debug log to /var/log/letsencrypt/letsencrypt.log
The requested nginx plugin does not appear to be installed
Ask for help or search for solutions at https://community.letsencrypt.org. See the logfile /var/log/letsencrypt/letsencrypt.log or re-run Certbot with -v for more details.

«Запрошенный плагин nginx, похоже, не установлен». Плагин — дополнение, которое умеет менять настройки nginx: на время проверки домена и потом, когда прописывает сертификат. В пакетах Ubuntu он лежит отдельно от самого Certbot.

Шаг 1. Узнайте, откуда установлен Certbot

command -v certbot

• Ответ /snap/bin/certbot — Certbot установлен из snap. В нём плагин nginx уже есть, переходите к шагу 3.
• Ответ /usr/bin/certbot — Certbot установлен через apt. Нужен шаг 2.

Шаг 2. Поставьте плагин nginx

Есть два пути. Первый — поставить плагин из тех же пакетов Ubuntu:

sudo apt install python3-certbot-nginx

apt покажет, что будет установлено, и спросит подтверждение — напечатайте y и нажмите Enter. Если apt выдаст ошибку, разбор — на странице Ошибки apt и sudo.

Второй путь — перейти на Certbot из snap: там уже есть плагины для nginx и Apache. Как удалить старый Certbot и поставить новый, написано в Как поставить сертификат на свой VPS.

Шаг 3. Повторите команду

Сначала проверьте всё на тестовом сервере Let’s Encrypt:

sudo certbot certonly --nginx --dry-run -d example.com -d www.example.com

Если в конце строка The dry run was successful., выпустите сертификат:

sudo certbot --nginx -d example.com -d www.example.com

Если сообщение другое: The nginx plugin is not working

Saving debug log to /var/log/letsencrypt/letsencrypt.log
The nginx plugin is not working; there may be problems with your existing configuration.
The error was: NoInstallationError("Could not find a usable 'nginx' binary. Ensure nginx exists, the binary is executable, and your PATH is set correctly.")
Ask for help or search for solutions at https://community.letsencrypt.org. See the logfile /var/log/letsencrypt/letsencrypt.log or re-run Certbot with -v for more details.

Здесь плагин есть, но сам nginx Certbot не нашёл: программа nginx не установлена. Поставьте её — Как разместить сайт на VPS: шаг 2.

Если после The error was: написано что-то другое, плагин не смог прочитать настройки nginx. Проверьте их командой sudo nginx -t и исправьте ошибку по странице Все ошибки nginx.

Как проверить

Команда с ключом --dry-run заканчивается строкой The dry run was successful.

Похожие ошибки

Тексты сообщений сверены с исходным кодом Certbot 5.8.0 — эта версия ставится через snap, как в инструкции Бесплатный SSL-сертификат, — и сервера Let’s Encrypt. В Certbot 2.9.0 из пакетов Ubuntu 24.04 вместо Identifier: стоит Domain:, а некоторые строки могут немного отличаться.

Источники

• Исходный код Certbot 5.8.0: selection.py — тексты does not appear to be installed и is not working.
• Исходный код Certbot 5.8.0: configurator.py — текст Could not find a usable nginx binary.
• Сборка Certbot для snap: snapcraft.yaml — плагины в составе snap и таймер продления.
• Пакет python3-certbot-nginx в Ubuntu 24.04 — плагин nginx для Certbot из пакетов.

Сверено 10 октября 2026 года.

Что почитать дальше

• Как поставить сертификат на свой VPS.
• Как разместить сайт на VPS: HTTPS.
• Все ошибки Certbot.