Поиск
Ошибки

Laravel: No application encryption key has been specified — нет ключа APP_KEY

Laravel шифрует ключом APP_KEY cookie и сессии посетителей. Ключ хранится в файле .env в папке проекта. Если строка APP_KEY пустая или файла .env нет, Laravel не может работать и показывает эту ошибку. Ключ создаёт одна команда — php artisan key:generate.

≈ 6 мин чтения
Содержание 11

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

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Проверьте, есть ли файл настроек: ls -a .env.
  3. Если файла нет, создайте его из образца: cp .env.example .env.
  4. Создайте ключ: php artisan key:generate.
  5. Если настройки были закешированы, обновите кеш: php artisan config:cache.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). В папке проекта лежат файл artisan и папки public и storage.

Как выглядит ошибка

No application encryption key has been specified.

С APP_DEBUG=true в файле .env этот текст виден на странице ошибки. С APP_DEBUG=false посетитель видит 500 и Server Error, а текст ошибки записан в storage/logs/laravel.log.

Посмотреть, есть ли ключ:

grep '^APP_KEY=' .env

Ключа нет, если в ответе только APP_KEY=. Рабочий ключ выглядит так: APP_KEY=base64: и дальше длинная строка из букв и цифр.

Откуда берётся ключ

В новом проекте Laravel файл .env создаётся из образца .env.example. В образце строка ключа пустая: APP_KEY=. Ключ создаётся при установке проекта командой composer create-project: она сама запускает php artisan key:generate.

Ключ пропадает, когда проект переносят на сервер:

  • файл .env не загрузили — его не хранят в Git, потому что в нём пароли;
  • .env создали заново из .env.example, а ключ не создали.

Как создать ключ

php artisan key:generate

Команда создаёт случайный ключ и вписывает его в строку APP_KEY= файла .env. В ответе:

Application key set successfully.

Команду запускайте от пользователя, которому принадлежит файл .env. Если .env принадлежит www-data — sudo -u www-data php artisan key:generate.

Если ключ в файле уже есть, а сайт работает в режиме production — в .env стоит APP_ENV=production, — команда переспросит, точно ли менять ключ. Ответьте no, если ключ уже рабочий: почему — в разделе ниже.

ВариантЧто делает
php artisan key:generateсоздаёт ключ и пишет его в .env
php artisan key:generate --showтолько показывает новый ключ, в .env не пишет
php artisan key:generate --forceменяет ключ без вопроса — на рабочем сайте не используйте

Если ключ есть, а ошибка осталась

Настройки могли быть закешированы командой php artisan config:cache или php artisan optimize. Тогда Laravel читает настройки из кеша, а не из .env. Обновите кеш:

php artisan config:cache

Если кеш настроек не нужен, удалите его: php artisan config:clear.

Если ошибка осталась, проверьте, что правите тот проект, который открывает сайт. Папка сайта указана в настройке root в nginx: grep -R 'root ' /etc/nginx/sites-enabled/. Для Laravel там папка public внутри проекта.

Если пишет Unable to set application key

Unable to set application key. No APP_KEY variable was found in the .env file.

В файле .env нет строки APP_KEY=. Откройте файл: nano .env — и добавьте в начало строку:

APP_KEY=

Сохраните: Ctrl+O, Enter, выход — Ctrl+X. Снова выполните php artisan key:generate.

Unable to set application key. APP_KEY is already present in the environment.

Команда не нашла в .env строку с текущим ключом и видит, что APP_KEY задан в переменных окружения. Проверьте: printenv APP_KEY. Если ответ не пустой, ключ задан вне .env — например, командой export. Поменяйте его там, где он задан.

Если пишет Unsupported cipher or incorrect key length

Unsupported cipher or incorrect key length. Supported ciphers are: aes-128-cbc, aes-256-cbc, aes-128-gcm, aes-256-gcm.

Ключ есть, но длина не подходит. Для шифра aes-256-cbc, который стоит в Laravel по умолчанию, нужен ключ из 32 байт. Ключ из key:generate начинается с base64: — так Laravel понимает, что строку нужно раскодировать.

Ошибка появляется, если ключ скопировали не полностью или без начала base64:. Сравните строку с рабочей копией .env — например, со старого сервера. Если рабочего ключа нигде нет, создайте новый: php artisan key:generate --force, но прочтите сначала раздел ниже.

Почему ключ нельзя менять без нужды

По документации Laravel, после смены ключа:

  • все посетители выйдут из своих учётных записей — cookie сессий зашифрованы старым ключом;
  • данные, которые приложение зашифровало старым ключом, нельзя будет расшифровать.

Если ключ всё же меняете, старый можно оставить в строке APP_PREVIOUS_KEYS файла .env. Тогда Laravel сможет прочитать то, что зашифровано старым ключом:

APP_KEY=base64:новый-ключ
APP_PREVIOUS_KEYS=base64:старый-ключ

Если старых ключей несколько, их пишут через запятую.

Ключ — секрет: по нему можно подделать cookie сайта. Не публикуйте .env и не храните его в Git.

Ошибки и как их исправить

Что видитеПричинаЧто делать
No application encryption key has been specified.пустой APP_KEY или нет файла .envсоздайте ключ
ключ есть, ошибка осталасьнастройки закешированыобновите кеш
No APP_KEY variable was found in the .env file.в .env нет строки APP_KEYдобавьте строку
APP_KEY is already present in the environment.ключ задан вне .envнайдите, где задан
Unsupported cipher or incorrect key length.ключ скопирован не полностьюсравните с рабочей копией
все посетители разом вышли из учётных записейключ поменяливерните старый ключ в APP_PREVIOUS_KEYS
could not be opened in append modeLaravel не может писать в журналРазбор

Тексты сообщений сверены по исходному коду Laravel 13.42.0.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

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