Установка и развёртывание

Запуск ObserveAI on-premise за 15 минут

Эта инструкция описывает развёртывание собственного экземпляра ObserveAI на сервере заказчика (on-premise). Для использования SaaS-версии установка не требуется — достаточно регистрации на observeai.kayaniq.ru.

Способы получения программы

SaaS: регистрация на сайте, доступ через браузер. Установка не требуется.
On-premise: установка на сервере заказчика по этой инструкции. Дистрибутив запрашивается по адресу [email protected].

Шаг 1. Системные требования

Минимальная конфигурация:

Процессор x86-64, не менее 4 ядер с поддержкой SSE4.2
Оперативная память не менее 8 ГБ
Свободное дисковое пространство не менее 100 ГБ (рекомендуется SSD)
Операционная система: Ubuntu 22.04 LTS / Debian 12 / РЕД ОС 7 / Astra Linux SE 1.7
Открытые порты 80 (HTTP), 443 (HTTPS)
Доменное имя с настроенными A/AAAA-записями (для HTTPS Let's Encrypt)

Шаг 2. Установка зависимостей

На целевом сервере должны быть установлены Docker Engine 24.0+ и Docker Compose Plugin 2.20+.

# Ubuntu / Debian
sudo apt update
sudo apt install -y docker.io docker-compose-plugin git
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
newgrp docker

Шаг 3. Получение дистрибутива

sudo mkdir -p /opt/observeai && cd /opt/observeai
sudo tar -xzf observeai-stack.tar.gz
sudo chown -R $USER:$USER /opt/observeai

Шаг 4. Настройка переменных окружения

cd /opt/observeai
cp .env.example .env

Отредактируйте .env:

POSTGRES_PASSWORD — пароль PostgreSQL
CLICKHOUSE_PASSWORD — пароль ClickHouse
JWT_SECRET — случайная строка не менее 32 символов
YOOKASSA_SHOP_ID и YOOKASSA_SECRET_KEY — для онлайн-приёма платежей (опционально для on-premise)
SMTP_* — почтовый сервер для уведомлений (опционально)

Для генерации случайных секретов:

openssl rand -hex 32

Шаг 5. Запуск

# Запуск всех сервисов
docker compose up -d

# Проверка статуса
docker compose ps

Все контейнеры (postgres, redis, clickhouse, observeai-backend, nginx) должны быть в состоянии «Up» или «healthy».

Шаг 6. Настройка HTTPS

Для получения SSL-сертификата Let's Encrypt:

make ssl-init [email protected]

Сертификат выпускается на все домены в конфигурации nginx. Автоматическое продление выполняется контейнером certbot каждые 12 часов.

Шаг 7. Проверка установки

curl -s https://observeai.kayaniq.ru/health

Ответ должен содержать статус ok или healthy.

Шаг 8. Первый пользователь

Перейдите по адресу /login в браузере, заполните форму регистрации. Первый зарегистрированный пользователь автоматически становится владельцем организации с полными правами.

Обновление

cd /opt/observeai
git pull   # или распаковка нового архива
docker compose pull
docker compose up -d --build

Бэкап перед обновлением: перед обновлением мажорной версии создайте резервную копию базы данных командой docker compose exec postgres pg_dumpall -U observeai > backup_$(date +%F).sql.

Возможные проблемы

Контейнеры не запускаются — проверьте журналы: docker compose logs --tail 50
Permission denied — пользователь не в группе docker, повторите шаг 2
ClickHouse в состоянии «unhealthy» — увеличьте таймаут или проверьте журналы CH
Порт 80/443 занят — убедитесь, что не запущен другой веб-сервер (Apache, Nginx)

Контакты технической поддержки

По вопросам установки: [email protected]