> 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/ustanovka-i-obnovlenie/sistemnye-trebovaniya.md).
# Системные требования
Для первичной установки iEXExchanger нужен чистый Linux-сервер с полным административным доступом.
Клиентский сайт, административная панель, базы данных и фоновые службы размещаются на одном сервере. На начальном этапе отдельные серверы для компонентов системы не требуются.
## Какой сервер выбрать
Для нового небольшого проекта рекомендуем **4 vCPU, 8 ГБ RAM и 80 ГБ NVMe**. Такая конфигурация подходит как отправная точка; по мере роста проекта ресурсы можно увеличивать.
| Вариант | Конфигурация сервера | Когда подходит |
| ------------------------ | ---------------------------------------- | ----------------------------------------------------------------------------- |
| Небольшой проект | 2–4 vCPU, 8 ГБ RAM, от 80 ГБ NVMe | Начало работы, небольшой объём данных и преимущественно лёгкие фоновые задачи |
| Рабочий проект с запасом | 4 vCPU, 12–16 ГБ RAM, 120–160 ГБ NVMe | Более активная работа сайта, отчёты, фоновые задачи и рост базы данных |
| Повышенная нагрузка | От 8 vCPU, 16–32 ГБ RAM, 160–250 ГБ NVMe | Больше одновременных запросов, обработки данных и фоновых операций |
Конфигурации в таблице — начальные ориентиры. При выборе учитывайте не только число заявок, но и одновременную работу пользователей, сложность отчётов, обработку файлов, внешние интеграции и объём резервных копий.
Если проект будет хранить много документов, изображений или большую историю резервных копий, выбирайте более вместительный диск. Заранее уточните у провайдера возможность увеличения CPU, RAM и дискового пространства.
## Как понимать ресурсы сервера
### Процессор
vCPU — вычислительные ресурсы сервера. Они используются при открытии страниц, работе административной панели, обработке заявок и выполнении фоновых задач.
Для небольшой нагрузки можно начать с 2 vCPU. Конфигурация с 4 vCPU оставляет больше запаса для одновременной работы сайта и фоновых процессов.
Уточняйте у провайдера ограничения продолжительной процессорной нагрузки. Одинаковое число vCPU на разных тарифах не гарантирует одинаковую скорость.
### Оперативная память
RAM — оперативная память, которую одновременно используют сайт, административная панель, базы данных и фоновые службы. Часть памяти занята даже при отсутствии посетителей.
Дополнительная RAM полезна при обработке больших файлов, построении отчётов и выполнении нескольких задач одновременно. Во время установки необходимые настройки подбираются по фактически доступным ресурсам сервера.
### Место на диске
Для основного диска выбирайте **NVMe** или быстрый SSD. Скорость накопителя влияет на работу базы данных, загрузку файлов, резервное копирование и обновления.
На диске хранятся:
* ОС и серверные компоненты;
* файлы iEXExchanger и базы данных;
* загруженные изображения, документы и другие файлы;
* журналы работы;
* резервные копии и сохранённые версии продукта;
* временные файлы установки, обновления и восстановления.
{% hint style="info" %}
Перед установкой должно оставаться **не менее 60 ГиБ свободного места — около 65 ГБ**. Это свободное пространство после размещения ОС и установочных файлов, а не общий объём диска в тарифе. Для начала выбирайте диск от 80 ГБ.
{% endhint %}
Увеличение RAM не заменяет увеличение диска: оперативная память нужна для выполнения задач, а накопитель — для хранения данных.
## Запас диска для резервных копий и обновлений
При обновлении место требуется одновременно для действующей версии, новой версии, резервной копии и временных данных. Поэтому размер скачанного архива не показывает весь необходимый запас.
Планируйте объём накопителя так, чтобы после размещения данных оставалось примерно **20–25% свободного места**, а также пространство для подготовки обновлений. По мере роста базы данных и загруженных файлов этот запас будет уменьшаться.
Более вместительный диск нужен, если:
* на сервер регулярно загружаются документы, изображения и другие файлы;
* быстро увеличивается база данных;
* требуется длительная история резервных копий;
* сохраняется несколько предыдущих версий продукта;
* резервные копии размещаются на том же сервере.
{% hint style="warning" %}
Недостаток свободного места может помешать созданию резервной копии, установке обновления и записи данных. Выбирайте тариф с запасом и возможностью расширения диска.
{% endhint %}
### Внешнее резервное копирование
Копия на том же сервере помогает восстановить приложение после ошибки или неудачного изменения. Для восстановления после потери сервера или повреждения его диска нужна копия в отдельном хранилище.
При выборе хостинга предусмотрите внешнее резервное копирование. Снимки сервера у провайдера можно использовать как дополнительную защиту. Внешнее хранилище не отменяет необходимость свободного места на основном сервере.
## Требования к серверу
### Тип сервера
Подойдут **VPS, VDS или выделенный сервер** с полноценным Linux-окружением и административным доступом. Обычный виртуальный хостинг без управления системными службами не подходит.
### Операционная система
Для установки поддерживаются следующие варианты:
| Операционная система | Архитектура |
|---|
| Ubuntu 26.04 LTS | amd64 или arm64 |
| Debian 13 | amd64 |
Если специальных требований нет, выбирайте **Ubuntu 26.04 LTS amd64**. У провайдера архитектура `amd64` также может называться `x86_64`.
Используйте одну из указанных версий ОС. Другие версии не предназначены для текущей первичной установки iEXExchanger.
### Чистый сервер
Заказывайте сервер с чистой ОС, без FASTPANEL и других панелей управления. На нём не должно быть действующих сайтов, рабочих баз данных, прежней установки iEXExchanger или заранее настроенного окружения приложения.
Если на сервере уже есть нужные данные, для первичной установки используйте другой чистый сервер. Обновление или перенос существующего проекта выполняются по отдельным инструкциям.
### Программное окружение
Заранее устанавливать серверные программы не нужно. Установщик iEXExchanger самостоятельно подготавливает окружение для сайта и административной панели, создаёт базы данных, настраивает HTTPS, системные службы, фоновые задачи, сетевую защиту и локальное резервное копирование.
### Доступ к серверу
Для установки требуется удалённый доступ по SSH от пользователя `root` с полными правами управления сервером.
Подготовьте данные подключения:
* публичный IP-адрес сервера;
* фактический порт SSH;
* пароль или SSH-ключ.
Также нужен доступ к консоли сервера в кабинете провайдера. Она позволит восстановить подключение, если SSH станет недоступен.
## Домены и сетевой доступ
### Домены
Для работы iEXExchanger нужны два адреса:
* `https://ваш_домен` — клиентский сайт обменного пункта;
* `https://app.ваш_домен` — Backend: серверная часть, административная панель и API.
Подготовьте доступ к DNS-настройкам обоих адресов, чтобы направить домены на сервер. Домены можно подключить напрямую или через Cloudflare либо другой совместимый сервис проксирования.
### IP-адрес
Сервер должен иметь **публичный IPv4-адрес**.
IPv6 можно использовать дополнительно. Если для домена создана AAAA-запись, указанный в ней IPv6-адрес должен принадлежать серверу и быть доступен из интернета.
### Порты и подключение к интернету
Должны быть доступны:
* фактический порт SSH — для подключения и обслуживания;
* порт `80` — для HTTP;
* порт `443` — для HTTPS.
Провайдер должен разрешать исходящие подключения, необходимые для установки серверных компонентов, получения HTTPS-сертификата, проверки лицензии и работы подключённых внешних сервисов.
При выборе тарифа также учитывайте скорость подключения и лимит трафика. Трафик расходуется на посещения сайта, передачу файлов, обращения к внешним сервисам и внешнее резервное копирование.
## Проверка перед установкой
Перед началом убедитесь, что:
* выбраны поддерживаемая ОС и подходящая архитектура;
* CPU, RAM и общий объём диска соответствуют выбранной конфигурации;
* после подготовки ОС и установочных файлов достаточно свободного места;
* сервер чистый, без панелей управления и действующих проектов;
* доступен вход по SSH от `root` и консоль провайдера;
* есть публичный IPv4-адрес, основной домен, технический поддомен и доступ к DNS;
* доступны порты SSH, HTTP, HTTPS и необходимые исходящие подключения;
* предусмотрены внешние резервные копии и возможность расширения ресурсов.
---
# 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/ustanovka-i-obnovlenie/sistemnye-trebovaniya.md?ask=&goal=
```
`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.