> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/1.-podgotovka/03-installation-acceptance.md).

# Установка и приёмка системы

Примите новую установку, проверьте HTTPS, службы, резервные копии и готовность панели

## Что вы получите

Новая система установлена на поддерживаемом чистом сервере штатным Installer, а владелец принял не только страницу входа, но и полный рабочий контур: HTTPS, фоновые службы, резервные копии, Update Agent и панель управления.

{% hint style="info" %}
Если обменник уже установлен и работает, переустанавливать его ради курса не нужно. Зафиксируйте текущее состояние и переходите к [доступам, резервной копии и режиму работы](https://docs.iexexchanger.com/learn/1.-podgotovka/02-safe-environment.md). Перенос действующего проекта на новую схему развёртывания выполняется как отдельная операция с резервной копией и планом возврата.
{% endhint %}

## Разделите ответственность

| Участник               | Что делает                                                                         |
| ---------------------- | ---------------------------------------------------------------------------------- |
| Владелец               | Передаёт домены, лицензию и требования, затем принимает результат                  |
| Технический специалист | Проверяет сервер и архивы, выполняет установку, диагностику и восстановление копии |
| Администратор          | Проверяет вход, права, службы и основные экраны панели                             |

Установка изменяет сервер и требует root-доступа. Не передавайте пароль root, лицензионный архив или секреты через GitBook, общий чат и снимки экрана.

## Подготовьте чистый сервер и файлы

Текущий production-профиль поддерживает Ubuntu 26.04 на `amd64` и `arm64`, а также Debian 13 на `amd64`. Debian 13 `arm64` требует отдельной приёмки. Сверьте этот список с инструкцией именно к полученному комплекту перед заказом сервера.

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

Для новой установки нужны:

* `iex-installer-linux.zip` и опубликованная рядом контрольная сумма;
* `iexexchanger_backend_full.zip`;
* `iexexchanger_frontend_full.zip`;
* лицензионный ZIP, выданный для этого проекта;
* реальные домены панели и клиентского сайта;
* E-mail для выпуска TLS-сертификата.

Архивы `*_update.zip` предназначены для обновления уже установленной системы и не заменяют `*_full.zip` при первой установке.

{% hint style="danger" %}
Не распаковывайте продуктовые ZIP вручную в каталог работающего сайта и не отключайте проверку контрольных сумм. Backend и frontend должны принадлежать одной поставке, а Installer — подтвердить их назначение и совместимость до изменения сервера.
{% endhint %}

## Выполните установку штатным способом

Технический специалист использует инструкцию из поставки и проходит один последовательный процесс.

{% stepper %}
{% step %}

### Проверьте комплект Installer

Сверьте опубликованную SHA-256, распакуйте Installer в отдельный закрытый каталог и повторно проверьте его внутренний `SHA256SUMS`.
{% endstep %}

{% step %}

### Подготовьте защищённую конфигурацию

Создайте `install.yaml` из примера, укажите реальные домены и параметры проекта и ограничьте доступ к файлу. Не вставляйте его содержимое в обращение поддержки: там могут находиться installation-bound данные.
{% endstep %}

{% step %}

### Выполните предварительную проверку

Запустите `config validate`, затем `checklist` и `plan`. Устраните блокирующие ошибки по серверу, DNS, архивам и лицензии до команды установки.
{% endstep %}

{% step %}

### Запустите одну установку

Выполните штатную команду `install` из текущего руководства Installer. Не запускайте второй процесс параллельно и не заменяйте системные пакеты вручную во время выполнения.
{% endstep %}

{% step %}

### Продолжите тот же запуск после прерывания

Если процесс прервался, используйте `resume` с тем же `install.yaml`, тем же комплектом архивов и той же сборкой Installer. Новый запуск с другими файлами не является продолжением прежней операции.
{% endstep %}
{% endstepper %}

Installer подготавливает веб-сервер, PHP, Node.js, PostgreSQL, Redis, TLS, firewall, фоновые процессы, расписание, резервное копирование и постоянные инструменты `iexctl`, Updater и Update Agent. Версии серверного стека задаёт текущий профиль поставки; не подменяйте его произвольными версиями из старой инструкции.

## Примите технический результат

После завершения специалист должен подтвердить:

1. `verify` успешно проверяет установленный релиз и публичные точки;
2. `iexctl doctor` не показывает необъяснённых критических нарушений;
3. клиентский домен и адрес панели открываются по HTTPS;
4. Frontend, Horizon, Reverb, Pulse и планировщик работают;
5. Update Agent доступен приложению;
6. резервная копия создаётся, проходит проверку и видна в списке снимков;
7. `restore-test` проверяет восстановимость последней копии во временной изолированной области, не затрагивая рабочие базы;
8. отчёты установки сохранены в закрытом рабочем журнале.

Наличие файла резервной копии без успешной проверки восстановления не считается приёмкой.

## Примите систему из панели

{% stepper %}
{% step %}

### Войдите по выданному адресу

Смените временный пароль администратора, настройте личную учётную запись и не сохраняйте исходные данные доступа в документации.
{% endstep %}

{% step %}

### Проверьте службы

Откройте **«Утилиты» — «Службы»**. Убедитесь, что основные процессы имеют ожидаемое состояние, а Update Agent и резервное копирование отображаются без ошибки связи.
{% endstep %}

{% step %}

### Проверьте обновления в режиме просмотра

Откройте **«Обновления»**. Панель должна показать установленную версию, состояние агента и вкладку установленных версий. Загружать новый релиз для этой проверки не нужно.
{% endstep %}

{% step %}

### Запустите диагностику

Откройте **«Утилиты» — «Диагностика системы»** и сохраните первый полный отчёт. Разберите предупреждения до настройки финансового контура.
{% endstep %}
{% endstepper %}

## Не смешивайте установку и обновление

{% tabs %}
{% tab title="Новая установка" %}
Используются чистый сервер, Installer, два `*_full.zip` и архив лицензии. Результатом является первый принятый релиз и готовая инфраструктура.
{% endtab %}

{% tab title="Обновление" %}
Используются два `*_update.zip` одной поставки. Обновление планируется и выполняется через [раздел «Обновления»](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/06-system-updates.md) с обязательной резервной копией и возможностью контролируемого отката.
{% endtab %}
{% endtabs %}

## Этап завершён, если

* [ ] использован поддерживаемый чистый сервер;
* [ ] FastPanel и другая панель хостинга не установлены как обязательная зависимость;
* [ ] контрольные суммы Installer и его комплекта подтверждены;
* [ ] backend, frontend и лицензия относятся к одному проекту и правильному типу установки;
* [ ] предварительный план не содержит блокирующих ошибок;
* [ ] прерванный процесс продолжался теми же файлами, а не запускался заново;
* [ ] HTTPS работает на клиентском сайте и панели;
* [ ] диагностика служб и `iexctl doctor` не содержат необъяснённых критических ошибок;
* [ ] резервная копия создана, проверена и прошла `restore-test`;
* [ ] панель видит Update Agent и установленную версию;
* [ ] секреты и отчёты установки не опубликованы.

После приёмки подготовьте [доступы, резервную копию и безопасный режим настройки](https://docs.iexexchanger.com/learn/1.-podgotovka/02-safe-environment.md).
