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

Требования к серверу, установка одной командой, первый вход по PIN и состав разделов.

Rivo ставится на один VPS и целиком принадлежит владельцу: данные, ключи шифрования и резервные копии не покидают сервер. Короткая версия — на странице Установка.

Что нужно до установки

	Минимум	Рекомендуется
ОС	Ubuntu 22.04 / 24.04, x86_64 (про arm64 — спросите на [email protected])	Ubuntu 24.04
Процессор	1 vCPU	2 vCPU
ОЗУ	1 ГБ	2 ГБ
Диск	5 ГБ свободно	20–40 ГБ (база, документы, бэкапы)
Сеть	публичный IP, открытые порты 80 и 443

Порты 80 и 443 должны быть свободны — на них встаёт Caddy и сам выпускает HTTPS-сертификат. Если там уже работает nginx или apache, уберите его или задайте Rivo другие порты (HTTP_PORT, HTTPS_PORT) и проксируйте сами.
DNS. Заведите A-запись домена (например, rivo.example.com) на IP сервера до установки и дождитесь, пока она разойдётся (dig +short rivo.example.com). Без неё сертификат не выпустится.

Установка одной командой

curl -fsSL https://get.me.rivo.day/install.sh | sudo bash -s -- --domain rivo.example.com --email [email protected]

Установщик ставит Docker, скачивает готовые образы и разворачивает всё в /opt/rivo. Ничего не собирается на сервере — это занимает пару минут. Без флагов он сам спросит домен, почту и лицензионный ключ.

Параметр	Зачем
`--license RIVO-…`	лицензионный ключ из кабинета. Необязателен: ключ можно ввести позже в Настройки → Лицензия
`--version 1.4.2`	поставить конкретную версию, а не последнюю
`--dir /opt/rivo`	другой каталог установки
`--yes`	ничего не спрашивать (для автоматизации)
`--no-schedule`	не включать ежедневный бэкап
`--registry-user U --registry-token T`	доступ к закрытому registry (выдаётся в кабинете)

Установщик сам генерирует секреты (APP_SECRET, VAULT_KEY, пароль базы) и случайный PIN входа — инстанс не остаётся открытым ни минуты. Схема базы создаётся при первом старте, ручных шагов нет. Повторный запуск безопасен: секреты, данные и версия не меняются.

Первый вход

В конце установщик печатает PIN — один раз:

  PIN входа: 481907  ← запиши сейчас, больше он нигде не покажется

Откройте https://ваш-домен и введите его. Дальше:

Смените PIN на свой — Настройки → Доступ.
Сохраните копию /opt/rivo/deploy/.env вне сервера (например, в менеджере паролей). Без APP_SECRET и VAULT_KEY загруженные файлы и пароли не расшифровать ничем — даже из бэкапа.
Сохраните BACKUP_PASSPHRASE, который установщик напечатал в конце, — без него резервные копии не открываются.
По необходимости: ключ LLM для ассистента, токен Telegram-бота, Google-календарь, валюта и часовой пояс.

Какие разделы включены

Состав разделов задаёт лицензия: тариф сменился — состав поменялся сам. Без лицензии включено всё. Урезать состав можно строкой MODULES=… в deploy/.env (через запятую), затем rivo restart; выключенный модуль скрыт в интерфейсе.

Если что-то не так

Симптом	Что делать
Сайт не открывается	`rivo logs caddy`; проверьте A-запись и что 80/443 не закрыты файрволом (`ufw allow 80,443/tcp`)
Сертификат не выпускается	Let's Encrypt должен достучаться до сервера по 80-му порту; проверьте, что порт не занят другим веб-сервером
API в статусе `unhealthy`	`rivo logs api` — чаще всего не поднялась база или не хватило памяти
`не удалось скачать …`	registry закрыт: задайте `--registry-user`/`--registry-token` из кабинета

Забыли PIN

Сбросьте его в базе, впишите новый APP_PIN в /opt/rivo/deploy/.env и перезапустите стек:

cd /opt/rivo
docker compose -f deploy/docker-compose.yml --env-file deploy/.env exec -T db psql -U rivo -d rivo -c "DELETE FROM settings WHERE key='APP_PIN';"
rivo restart

Обновление и резервные копии — в статье Обновление, бэкап и восстановление.