Установка Orakul

Установка не требует специальных знаний. Вам не нужно уметь настраивать nginx, сертификаты или базу данных — всё это делает установщик. От вас требуется арендовать сервер, вставить одну команду в консоль, принять документы и ответить на три вопроса в браузере. Если что-то пойдёт не так — напишите нам, форма для этого в конце страницы. Мы отвечаем и, если нужно, заканчиваем установку сами: это входит во внедрение и ничего не стоит дополнительно.

Что подготовить заранее

• Сервер с Ubuntu: 2 ядра, 4 ГБ памяти, 40 ГБ диска. Этого достаточно для команды агентов.
• Домен для панели и A-запись, которая уже указывает на IP сервера, — по ней выпускается сертификат HTTPS.
• Лицензионный ключ Orakul — мы выдаём его при покупке.
• Три ключа доступа: токен Telegram-бота, ключ Google Gemini и ваш Telegram ID. Любое из этих полей можно оставить пустым и заполнить позже в панели — установка от этого не остановится.

Шаг 1. Сервер

Подойдёт любой провайдер, у которого есть Ubuntu. На скриншоте — Hetzner: тариф CX23 (2 vCPU, 4 ГБ, 40 ГБ SSD), образ Ubuntu, IPv4 и IPv6. Это примерно 6 € в месяц.

При создании сервера добавьте свой SSH-ключ — так вы попадёте в консоль без пароля. Если ключа нет, подойдёт и веб-консоль провайдера.

Минимальная конфигурация: 2 ядра, 4 ГБ памяти, 40 ГБ диска

Шаг 2. Скачать установщик

Подключитесь к серверу по SSH под root и скачайте скрипт:

wget -O install.sh https://orakul.digital/install.sh

Файл маленький, скачивается мгновенно

Шаг 3. Запустить с лицензионным ключом

Запустите скрипт и передайте ему свой ключ:

sudo bash install.sh ORK-XX-000000-XXXXXXXX-XXXXX

Скрипт проверит ключ, скачает дистрибутив и напечатает ссылку, по которой дальше всё происходит в браузере. Ссылка одноразовая и работает только для этой установки — откройте её на своём компьютере.

Ключ и ссылка на скриншоте свои у каждой установки

Шаг 4. Принять документы

Мастер состоит из шести экранов, и первые три — документы: лицензия (EULA), обработка данных (DPA) и стандартные договорные условия (SCC). Полный текст каждого виден прямо в окне, рядом — лицензионный ключ, на который он принимается. Пока галочка не поставлена, кнопка «Next» дальше не пускает.

Принятие фиксируется: дата и время (UTC), ваш IP, ключ и версия текста. Те же документы всегда открыты на сайте — по ссылкам выше и в подвале, так что читать их можно заранее, не торопясь во время установки.

DPA нужен там, где мы обрабатываем персональные данные по вашему поручению: поддержка, диагностика, внедрение. SCC применяются только если такие данные передаются за пределы ЕЭЗ, Великобритании или Швейцарии, — принимая их сейчас, вы получаете готовые условия на такой случай.

Шаг 1 из 6 — лицензия (EULA)

Шаг 2 из 6 — обработка данных (DPA)

Шаг 3 из 6 — международная передача данных (SCC)

Шаг 5. Язык панели и часовой пояс

Четвёртый экран мастера. Выбранный язык — это язык интерфейса панели и отчётов; позже его можно переключить. Часовой пояс важнее, чем кажется: по нему работают расписания, поэтому «каждый понедельник в 9:00» означает девять утра именно у вас.

Шаг 4 из 6

Шаг 6. Домен панели

Укажите домен, по которому будет открываться панель, и почту для Let's Encrypt — на неё придут письма об истечении сертификата. A-запись домена должна указывать на IP сервера до этого шага: сертификат выпускается прямо во время установки, и без записи выпустить его не получится.

Шаг 5 из 6

Шаг 7. Ключи доступа

Три поля, и под каждым — ссылка, где взять значение:

• Токен Telegram-бота. Отправьте /newbot боту @BotFather — он ответит токеном.
• Ключ Google Gemini. Создаётся в Google AI Studio; на нём работают агенты.
• Ваш Telegram ID. Напишите что угодно боту @userinfobot — он ответит числом. Нужен, чтобы бот отвечал вам и чтобы у вас был доступ в панель.

Любое поле можно оставить пустым: установка пройдёт, а ключ вы добавите потом в панели.

Шаг 6 из 6 — после него начинается сама установка

Шаг 8. Подождать 10–20 минут

Установщик ставит пакеты, браузеры и базу данных и показывает лог. Окно можно свернуть — процесс идёт на сервере и не прервётся.

Но закрывать окно браузера нельзя. Пароль администратора показывается в конце на этой же странице и больше нигде: закроете вкладку — пароль потеряется. Сворачивайте, переключайтесь на другие вкладки, занимайтесь своими делами — только не закрывайте.

Лог видно прямо на странице; вкладку до конца установки не закрывайте

Готово

В конце мастер показывает адрес панели, логин admin и пароль. Сохраните пароль сразу — страница закрывается через 10 минут после окончания установки. Там же напоминание удалить файл с ответами, в котором остались ваши ключи:

rm /opt/orakul-dist/deploy/install.env

Telegram-бот ответит, как только вы напишете ему первое сообщение.

Пароль генерируется при установке — этот давно не действует

Первый запуск: как быстро разобраться

Зайдите в панель по адресу с финального экрана — логин admin и пароль оттуда же. Разбираться в одиночку не придётся: при первом входе панель показывает, какие агенты уже стоят из коробки.

• Orakul Help (@help) — справка по самой панели: настройка, ключи, создание агентов, ошибки.
• Assistant (@assistant) — общие вопросы и всё, что не подошло другим агентам.
• Prompt Builder (@prompt_builder) — напишет системный промпт для новой роли: задаст уточняющие вопросы и отдаст готовый текст.

Окно показывается один раз на браузер; кнопка сразу открывает чат со справочным агентом

Кнопка «Спросить Orakul Help» открывает чат с уже заданным вопросом «Что ты умеешь?» — и агент отвечает картой системы: где взять ключи и куда их вставить, как создать агента через «Субагенты → Нанять специалиста», как раздать доступы сотрудникам и как поставить задачу на расписание. Это быстрее, чем искать по интерфейсу: агент знает панель и отвечает про неё, а не общими словами.

Справочный агент отвечает по вашей установке — с названиями разделов панели

Разумный порядок первого часа: спросить @help, что он умеет; дописать недостающие ключи в разделе «API Keys»; собрать первого агента под свою задачу с помощью Prompt Builder; поставить ему задачу в чате и посмотреть на результат. К этому моменту становится понятно, как устроена система, — дальше настройка идёт по вашим процессам.

Если установка завершилась с ошибкой

Такое бывает: провайдер отдал пакет с ошибкой, домен ещё не разошёлся по DNS, кончилось место. Мастер в этом случае показывает экран с логом и кнопками «Copy log» и «Download full log».

Ничего переустанавливать не нужно. Обычно большая часть шагов уже выполнена, и установку можно продолжить с места обрыва, а не начинать заново. Скопируйте лог и отправьте его нам формой ниже — разберёмся и допишем, что делать дальше.

Кнопка «Copy log» кладёт лог в буфер обмена целиком