Определите, на каком этапе возникает ошибка.

Если не удаётся загрузить лицензионный ключ

Проверьте название скачанного файла. Браузер может добавить к имени (1), (2) или (Copy) при повторном скачивании. Восстановите исходное название файла и повторите загрузку.

Если ошибка сохраняется, замените лицензионный ключ вручную:

1. Скачайте актуальный лицензионный ключ с клиентского портала
2. Проверьте, что название файла не содержит добавленных символов
3. На Windows откройте свойства файла и, если доступен пункт Разблокировать, примените разблокировку
4. Обновите страницу Информация о лицензии и проверьте результат

Если ошибка возникает при первоначальной настройке и раздел Информация о лицензии ещё недоступен, после замены файла вернитесь к соответствующему этапу мастера установки.

Если не удаётся зарегистрировать владельца

При первоначальной настройке Пассворка регистрируется первый пользователь — Владелец организации.

• Проверьте заполнение обязательных полей и сообщения об ошибках
• Убедитесь, что пароль соответствует требованиям формы и совпадает с подтверждением
• Проверьте, не подставил ли браузер сохранённые данные другого аккаунта

Если после нажатия кнопки регистрации появляется ошибка

1. Откройте инструменты разработчика браузера
2. Перейдите на вкладку Network
3. Повторите действие и найдите запрос, завершившийся с ошибкой
4. Сохраните адрес запроса, HTTP-код и текст ответа без конфиденциальных данных
5. Проверьте сообщения на вкладке Console

Если запрос не отправляется, проверьте сообщения возле полей формы и ошибки в Console.

При ошибке соединения проверьте доступность сервера и настройки обратного прокси. Если APP_URL уже задан в config.env, значение должно соответствовать адресу Пассворка в браузере, включая HTTPS.

Если мастер установки появляется повторно

Администратору следует проверить сохранение конфигурации и подключение к базе данных:

• Наличие config.env и доступность файла для процесса PHP
• Параметры подключения к используемой базе данных
• Сохранность каталогов конфигурации и данных после перезапуска служб или контейнеров
• Отсутствие переключения на другую базу данных или другой экземпляр Пассворка

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

Для обращения в техническую поддержку подготовьте:

• Версию Пассворка, операционной системы и способ установки
• Этап возникновения ошибки: загрузка лицензии, создание владельца или завершение мастера
• Название файла лицензионного ключа
• Точный текст ошибки и скриншот страницы без паролей
• HTTP-код и ответ проблемного запроса, сообщения из Console
• Информацию о предыдущих попытках настройки и наличии данных в подключённой базе
• Архивы отладочной информации и результаты выполненных проверок

Перед отправкой исключите из материалов пароли, токены, cookie-файлы сессии и ключи шифрования.

Более подробно:

• Мастер установки и загрузка лицензионного ключа
• Роль владельца организации
• Параметры config.env
• Сбор отладочной информации

Проверьте адрес, по которому открываете Пассворк, и сохраните точный текст ошибки браузера. Ошибка соединения, предупреждение о сертификате и пустая страница требуют разных проверок.

«Если браузер не может найти сервер или установить соединение»

• Проверьте правильность доменного имени, протокола HTTPS и порта в адресной строке
• Если мастер установки уже выполнен, проверьте, что параметр APP_URL в config.env соответствует адресу Пассворка
• Убедитесь, что доменное имя разрешается в IP-адрес сервера или обратного прокси
• Проверьте подключение к корпоративной сети или VPN
• Проверьте доступность порта HTTPS и состояние веб-сервера

APP_URL задаёт адрес Пассворка, но не создаёт DNS-запись и не открывает сетевой порт. Если браузер не находит сервер или соединение отклоняется, дополнительно следует проверить DNS, сеть и веб-сервер.

Если браузер предупреждает о сертификате

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

Проверьте:

• Соответствие имени в сертификате адресу Пассворка
• Срок действия сертификата
• Дату и время на компьютере
• Наличие доверия к центру сертификации и корректность цепочки сертификатов

Для постоянной работы настройте сертификат для доменного имени Пассворка. При использовании корпоративного центра сертификации следует обеспечить доверие к корневому сертификату на клиентских устройствах.

Если открывается стандартная страница Nginx, Apache или IIS

Проверьте:

• Привязку доменного имени к сайту Пассворка
• Настроенный порт и HTTPS-привязку
• Корневой каталог сайта, который должен указывать на каталог public установленного Пассворка
• Адрес назначения на обратном прокси, если подключение проходит через прокси

Сверьте конфигурацию с инструкцией для выбранного способа установки.

Если отображается пустая страница или бесконечная загрузка

1. Откройте Пассворк в приватном окне браузера и сравните результат
2. Откройте инструменты разработчика и перейдите на вкладку Console
3. Перейдите на вкладку Network и обновите страницу
4. Сохраните сообщения об ошибках, адреса неуспешных запросов и коды ответов

Если не загружаются файлы JavaScript или CSS, проверьте пути к файлам и правила веб-сервера. Если ошибки возникают в запросах к API, проверьте обработку запросов на сервере и прокси.

Код ошибки:

Код ошибки помогает выбрать направление проверки, но точную причину следует устанавливать по логам.

• 403 — доступ запрещён: Права веб-сервера на файлы, правила ограничения доступа и настройки прокси
• 404 — страница не найдена: Адрес страницы, корневой каталог сайта и правила обработки запросов
• 500 — внутренняя ошибка: Логи PHP и веб-сервера за время возникновения ошибки
• 502 или 503 — сервис недоступен: Состояние PHP-FPM или пула приложений IIS, контейнеров и соединение между прокси и сервером Пассворка

Для обращения в техническую поддержку подготовьте:

• Версию Пассворка, операционной системы и способ установки
• Адрес, по которому открываете Пассворк
• Текст ошибки или HTTP-код ответа
• Информацию о доступности страницы с других компьютеров
• Схему подключения: напрямую, через VPN, обратный прокси или балансировщик
• Скриншот страницы и ошибки из вкладок Console и Network, если страница начинает загружаться
• Архивы отладочной информации и результаты выполненных проверок

Перед отправкой удалите пароли, токены, cookie-файлы сессии и ключи шифрования. Диагностические материалы следует передавать через обращение в техническую поддержку.

Более подробно:

• Сбор отладочной информации для Docker
• Сбор отладочной информации через PowerShell
• Сбор отладочной информации для других способов установки

Сохраните текст ошибки и сообщения перед остановкой установки. Причина может быть связана с загрузкой компонентов, правами пользователя, проверкой архива или запуском служб. Последняя строка вывода часто сообщает только о завершении установки, поэтому следует найти первое сообщение об ошибке.

Проверьте условия установки

• Используется инструкция для выбранного способа установки: Docker, Windows Server с PowerShell-модулем или ручная установка
• Версия операционной системы и компонентов соответствует требованиям устанавливаемой версии Пассворка
• На диске достаточно свободного места для компонентов, распаковки архивов и базы данных
• У пользователя есть права на установку компонентов и запись в рабочие каталоги
• Выбран подходящий режим установки: онлайн при доступе к репозиториям или офлайн для закрытого контура

Требования к окружению приведены в технической документации.

Если не загружаются компоненты или архив Пассворка

Проверьте адрес, указанный в сообщении об ошибке. Доступность сайта с рабочего компьютера не подтверждает доступность с сервера установки.

• При ошибке разрешения имени проверьте DNS на сервере
• При тайм-ауте или отказе в соединении проверьте сетевой доступ, межсетевой экран и настройки прокси
• При ошибке TLS проверьте дату и время сервера, доверие к сертификатам и наличие подмены сертификатов корпоративным прокси
• При ошибке авторизации проверьте API-ключ клиентского портала, если установщик запрашивает ключ

В закрытом контуре следует использовать офлайн-инструкцию. Одного архива Пассворка недостаточно — необходимо заранее подготовить компоненты для выбранного способа установки.

Если установка в Docker остановилась

Проверьте доступность Docker и плагина Docker Compose:

docker version
docker compose version

Если Docker сообщает об отказе в доступе, проверьте права пользователя на работу с Docker. Если клиент не может подключиться к Docker daemon, проверьте состояние службы Docker.

Скрипт passwork_compose_install.sh при ошибках создаёт журнал с именем вида install_log_date.log. Сохраните журнал вместе с выводом терминала.

Если установка дошла до создания контейнеров, выполните из каталога с файлом Docker Compose:

docker compose ps -a
docker compose logs --tail=100

Проверьте контейнеры в состоянии Exited или Restarting и сообщения соответствующих служб. При ошибке занятого порта определите, какой процесс использует порт, и устраните конфликт в настройках размещения.

Если установка через PowerShell остановилась

Убедитесь, что PowerShell запущен от имени администратора.

• Если команда Install-Passwork не распознаётся, проверьте выполнение шага установки PowerShell-модуля
• Если не устанавливается компонент, сохраните название компонента и полный текст ошибки
• Если ошибка возникает при загрузке файлов, проверьте доступ к указанному адресу с сервера
• Если установка останавливается при настройке IIS или MongoDB, проверьте состояние соответствующей службы и журнал ошибок

Сообщения об ошибках установки отображаются в PowerShell. Скопируйте текст ошибки вместе с командой запуска и предшествующими сообщениями.

Если ошибка возникла при ручной установке

Продолжайте проверку с этапа, на котором появилась первая ошибка:

• При установке пакетов проверьте подключённые репозитории и совместимость версий
• При настройке PHP проверьте наличие обязательных расширений и используемый файл конфигурации
• При запуске веб-сервера проверьте конфигурацию, пути к файлам и права доступа
• При запуске MongoDB проверьте журнал службы, каталог данных и права пользователя службы

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

Если не проходит проверка цифровой подписи

Повторно получите архив, соответствующий файл подписи и открытый ключ из официального источника. Для офлайн-установки проверьте комплектность файлов и расположение согласно инструкции.

Ошибка проверки может указывать на повреждение архива или несоответствие файлов. Пропуск проверки подписи не устраняет причину ошибки.

Перед повторной попыткой

Устраните выявленную причину и проверьте, какие этапы уже выполнены. Если установщик успел создать контейнеры, службы или базу данных, повторный запуск следует выполнять с учётом текущего состояния установки.

Не удаляйте каталог данных MongoDB, Docker-тома и конфигурационные файлы для повторной установки без проверки содержимого. Удаление может привести к потере уже созданных данных.

Для обращения в техническую поддержку подготовьте:

• Версию Пассворка и название архива Пассворка
• Способ установки: Docker, PowerShell-модуль или ручная установка
• Соберите отладочную информацию
• Ссылку на использованную инструкцию
• Этап остановки, полный текст ошибки и сообщения перед ошибкой
• Информацию о доступе в интернет, использовании прокси и установке в закрытом контуре
• Результаты выполненных проверок и сведения о предыдущих попытках установки

Более подробно:

• Сбор отладочной информации для Docker
• Сбор отладочной информации через PowerShell
• Сбор логов на Linux
• Сбор логов на Windows Server