# Инструкция по установке Swarmica
# Системные требования

**ВНИМАНИЕ! Сервер может быть виртуальным, но только на технологиях гипервизорной виртуализации. Установка и запуск внутри гостевой ОС на контейнерной платформе виртуализации не поддерживается**

## ОС

Поддерживаемые версии ОС:

*   ![Логотип Alt Server 11.1: поддерживаемая Swarmica](https://support.swarmica.com/attachments/2/j/2jPOpQYzkvIX6DBM_a/altserver_monochrome.svg)Alt Server 11.1 (Альт Сервер 11.1)
*   ![Логотип Astra Linux 1.8: поддерживаемая Swarmica](https://support.swarmica.com/attachments/L/t/Lt3oByCVvUK8DVO2_a/astra.svg) Astra Linux 1.8
*   ![Логотип RedOS 8 стандартная: поддерживаемая Swarmica](https://support.swarmica.com/attachments/Z/I/ZIvDNee3nw_5rzDs_a/redos.svg) RedOS 8 Стандартная
*   ![Логотип RedOS 8 сертифицированная: поддерживаемая Swarmica](https://support.swarmica.com/attachments/Z/I/ZIvDNee3nw_5rzDs_a/redos.svg) RedOS 8 Сертифицированная
*   ![Логотип Ububtu 26.04 стандартная: поддерживаемая Swarmica](https://support.swarmica.com/attachments/o/S/oSXg5vrAIKFNfklY_a/ubuntu.svg) Ubuntu 26.04.x LTS
*   ![Логотип Ububtu 24.04 стандартная: поддерживаемая Swarmica](https://support.swarmica.com/attachments/o/S/oSXg5vrAIKFNfklY_a/ubuntu.svg) Ubuntu 24.04.x LTS
*   ![Логотип Ububtu 22.04 стандартная: поддерживаемая Swarmica](https://support.swarmica.com/attachments/o/S/oSXg5vrAIKFNfklY_a/ubuntu.svg) Ubuntu 22.04.x LTS (рекомендуется перейти на более новые версии)

## Минимальные

Минимальные требования для запуска приложения и его функционального тестирования:

```
CPU: 4 vCPU (Intel Core i5 / Xeon)
RAM: 16 GB
HDD: 50 GB SSD
```

## Рекомендованные

Для рабочих режимов эксплуатации:

```
CPU: Intel Xeon / i7 8 Core
RAM: 32 GB
HDD: 500GB SSD (желателен RAID массив)
```

## Требования к инфраструктуре

### Исходящий трафик

С сервера, на который будет устанавливаться продукт, необходим доступ до следующих ресурсов:

*   [https://reg.gl.swd.im](https://reg.gl.swd.im) - реестр образов контейнеров для приложения
*   [https://license.swarmica.com](https://license.swarmica.com) - сервер лицензионных ключей Swarmica
*   [https://mirror.gcr.io](https://mirror.gcr.io) - зеркало реестра образов контейнеров для связанных сервисов, таких как redis, postgres, traefik и т.д.
*   Зеркала или репозитории пакетов для ОС Ubuntu, настроенные на сервере

Если будет использоваться SMTP Relay для исходящей почты, то он также должен быть доступен с сервера приложения.

### Входящий трафик

*   Порты 80 и 443 - для WEB интерфейса
*   Порт 25 - если будет использоваться входящий канал электронной почты через SMTP

### DNS

*   Выбранное доменное имя должно разрешаться во внешний IP адрес системы (запись A типа)

Пример:

Для того, чтобы система была доступна по адресу [support.swarmica.com](https://support.swarmica.com), установленном на сервере с IP адресом [79.141.74.181](https://79.141.74.181) и нужно добавить следующие записи в DNS:

```
support.swarmica.com   A      79.141.74.181
```

### Входящая почта

Рекомендуемая конфигурация - получение почты через IMAP. Для этого подготовьте данные учетной записи, куда будет приходить почта для технической поддержки:

*   Адрес сервера
*   Порт (993)
*   Пользователь (обычно тот же, что и адрес почты, например, support@company.tld)
*   Пароль (обычно тот же, что и для пользователя, за исключением почты на сервисах [Gmail](https://support.swarmica.com/article/ru/431-podklyuchenie-elektronnoj-pochty-gmail.html), [Yandex Mail](https://support.swarmica.com/article/ru/430-podklyuchenie-elektronnoj-pochty-yandex.html), [Mail.ru](https://support.swarmica.com/article/ru/432-podklyuchenie-elektronnoj-pochty-mailru.html) - там требуется создать пароль приложения)

### Исходящая почта

Для отправки исходящей почты требуется настроить SMTP Relay - авторизованный SMTP сервер, который будет пересылать почту из системы внешним получателям.

Поддерживаются протоколы:

*   SMTP (25)
*   SMTP SSL (465)
*   SMTP TLS (587)

### Лицензия

Получите у представителя [Swarmica](mailto\:support@swarmica.com) следующие данные, необходимые для корректного запуска системы:

*   Лицензионный ключ Swarmica
*   Данные учетной записи для реестра образа контейнеров (логин и токен доступа)

# Установка

1\.  Скачайте архив на сервер, где планируется установка:

```bash
mkdir swarmica-installer
cd swarmica-installer
wget https://support.swarmica.com/attachments/installer/installer.tar.gz
```

:::tip
На RedOS необходимо установить утилиту `wget` следующей командой: `sudo dnf install wget`, если ее нет по умолчанию
:::

2\.  Распакуйте архив подходящей утилитой:

```bash
tar -xvzf installer.tar.gz
```

3\.  Добавьте пермиссий на выполнение:

```bash
chmod +x installer.sh
```

4\.   Запустите установку:

```bash
./installer.sh install
```

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

Помощь: `./installer.sh help`

Запуск в режиме DEBUG: `export DEBUG=1; ./installer.sh install`