#281: Swarmica Installation Guide
Отредактирована: сегодняSystem Requirements
ATTENTION! The server can be virtual, but only on hypervisor virtualization technologies. Installation and launch inside a guest OS on a container-based virtualization platform is not supported
OS
Supported OS versions:
Alt Server 11.1 (Astra Server 11.1)
Astra Linux 1.8
RedOS 8 Standard
RedOS 8 Certified
Ubuntu 26.04.x LTS
Ubuntu 24.04.x LTS
Ubuntu 22.04.x LTS (it is recommended to upgrade to newer versions)
Minimum
Minimum requirements for running the application and its functional testing:
CPU: 4 vCPU (Intel Core i5 / Xeon)
RAM: 16 GB
HDD: 50 GB SSD
Recommended
For operational modes:
CPU: Intel Xeon / i7 8 Core
RAM: 32 GB
HDD: 500GB SSD (RAID array is desirable)
Infrastructure Requirements
Outgoing Traffic
The server where the product will be installed must have access to the following resources:
- https://reg.gl.swd.im - container image registry for the application
- https://license.swarmica.com - Swarmica license key server
- https://mirror.gcr.io - mirror of the container image registry for related services such as redis, postgres, traefik, etc.
- Mirrors or package repositories for Ubuntu OS configured on the server
If SMTP Relay is used for outgoing mail, it must also be accessible from the application server.
Incoming Traffic
- Ports 80 and 443 - for WEB interface
- Port 25 - if an incoming email channel through SMTP is used
DNS
- The selected domain name must be resolved to the external IP address of the system (A record)
Example:
To make the system available at support.swarmica.com, installed on a server with IP address 79.141.74.181, you need to add the following records in DNS:
support.swarmica.com A 79.141.74.181
Incoming Mail
The recommended configuration is to receive mail through IMAP. To do this, prepare the account data where the technical support mail will arrive:
- Server address
- Port (993)
- User (usually the same as the email address, for example, support@company.tld)
- Password (usually the same as for the user, except for mail on services Gmail, Yandex Mail, Mail.ru - there you need to create an application password)
Outgoing Mail
To send outgoing mail, you need to configure SMTP Relay - an authorized SMTP server that will forward mail from the system to external recipients.
Supported protocols:
- SMTP (25)
- SMTP SSL (465)
- SMTP TLS (587)
License
Obtain the following data from the Swarmica representative, necessary for the correct start of the system:
- Swarmica license key
- Account data for the container image registry (login and access token)
Installation
- Download the archive to the server where the installation is planned:
mkdir swarmica-installer
cd swarmica-installer
wget https://support.swarmica.com/attachments/installer/installer.tar.gz
On RedOS, you must install the wget utility with the following command: sudo dnf install wget, if it is not the default
- Unpack the archive with a suitable utility:
tar -xvzf installer.tar.gz
- Add execution permissions:
chmod +x installer.sh
- Start the installation:
./installer.sh install
During installation, the initial launch may take several minutes - this is expected time. You do not need to take any action: the installer will occasionally check the availability of the system and report on the completion of the installation
Help: ./installer.sh help
Launch in DEBUG mode: export DEBUG=1; ./installer.sh install