Установка на сервер

Qubix работает на вашем собственном сервере — одна команда установки поднимает весь стек (базу данных, бэкенд, веб-сервер, вспомогательные сервисы). Вам нужен только чистый Linux-сервер с SSH-доступом и Docker.

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

Установщик проверяет сервер перед запуском и отказывается продолжать на машине, которая явно слишком мала. Рекомендуемый минимум:

Ресурс	Рекомендуемый минимум
CPU	4 vCPU
RAM	8 GB
Диск	20 GB SSD или HDD

Это значения, которые рекомендует установщик; ниже них система всё равно запустится, но предупредит, что ClickHouse будет работать медленно в загруженные дни. Есть жёсткое ограничение — 10 GB свободного диска: при меньшем объёме установка останавливается.

Тип диска не влияет на обслуживание трафика — подходят и SSD, и HDD; HDD позволяет сэкономить, SSD ускоряет только отчёты в панели администратора при больших объёмах данных. 20 GB с запасом хватает для старта: вмещает платформу, тысячи креативов, а история трафика занимает совсем немного. Подробнее о том, сколько трафика и креативов умещается на конкретном диске, читайте в разделе Выбор сервера.

Жёсткие требования:

• 64-битный Linux-сервер (VPS/VDS или выделенная машина), не личный компьютер и не виртуальный хостинг.
• Docker с плагином docker compose (V2). Старый отдельный docker-compose (V1) не поддерживается — установщик определяет его и останавливается.
• Исходящий HTTPS, чтобы сервер мог загрузить образы Qubix.

Чистый сервер

Устанавливайте Qubix на сервер, выделенный только для него. Стек рассчитывает на то, что порты 80, 443 (и 8443 для варианта с Cloudflare) свободны. Если другой веб-сервер уже занял их — освободите их сначала или выберите вариант с Cloudflare позже в мастере настройки.

Установка

1. Подключитесь к серверу по SSH от имени root.

2. Запустите команду установки:

   Bash

   curl -sSL https://qubix.pro/install.sh | bash

   (или wget -qO- https://qubix.pro/install.sh | bash)

   

3. Установщик выводит баннер Qubix, проверяет сервер, задаёт несколько вопросов (папка установки, на каком сетевом интерфейсе публиковать), затем загружает и запускает стек. Дождитесь сообщения о том, что всё поднялось.

Не прерывайте установку

Дайте установщику завершить работу. Остановка в середине процесса может оставить частично настроенный стек — в таком случае надёжнее всего удалить папку установки и запустить команду заново на чистом сервере.

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

Установщик запускает небольшой набор контейнеров, из которых состоит Qubix: аналитическая база данных, бэкенд Qubix, веб-сервер, а также сервисы автообновления, SSL-сертификатов и AI. Управлять ими вручную не нужно — Qubix делает это за вас.

Завершение настройки в браузере

Когда стек запущен, установщик выводит ссылку вида:

http://<your-server-ip>:7000/install?k=…

Откройте эту полную ссылку в браузере (ключ ?k=… обязателен). Она ведёт в мастер настройки, где вы выбираете способ доступа к Qubix, вводите лицензию и создаёте первого администратора.

Ссылка работает один раз

Мастер настройки доступен только до его завершения. После создания первого администратора ссылка перестаёт работать — это ожидаемое поведение. В дальнейшем вы входите по собственному адресу вашей панели.

Что дальше

Создание администратора

Пройдите мастер настройки: адрес, лицензия, администратор.

Обзор интерфейса

Как устроена панель администратора.