> 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" %}
Если обменник уже установлен и работает, переустанавливать его ради курса не нужно. Зафиксируйте текущее состояние и переходите к [доступам, резервной копии и режиму работы](/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` одной поставки. Обновление планируется и выполняется через [раздел «Обновления»](/learn/9.-sistema-i-rasshireniya/06-system-updates.md) с обязательной резервной копией и возможностью контролируемого отката.
{% endtab %}
{% endtabs %}

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/1.-podgotovka/03-installation-acceptance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.