SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Self-host Rakazo на VPS: власний AI-бот

Запустіть Rakazo на власному VPS: Node 22, pnpm, PostgreSQL і Graphile Worker у Docker Compose, вибір sandbox, ключі та реалістичні вимоги до ресурсів.

Які компоненти фактично працюють під час self-hosting Rakazo

Self-hosting Rakazo означає запуск п’яти компонентів на одному Linux-сервері: PostgreSQL, процесу Graphile Worker, API, web app і sandbox-контейнера, який виконує роль комп’ютера ботів. Rakazo — це open-source альтернатива Grok Bot, опублікована elie222 за ліцензією Apache 2.0. Кожен бот має власні розмови, пам’ять, процедури та історію. За замовчуванням він використовує один Team Computer разом з іншими ботами робочого простору, якщо йому не надати Private Computer. Також бот може створювати однорангових ботів або короткоживучих subagent. Якщо в цьому реченні незвично використано такі поняття, як пам’ять, subagent і виклик інструмента, спочатку варто витратити час на поступове ознайомлення з фактичною роботою агентів, оскільки більшість наведених нижче параметрів зрозумілі лише тоді, коли ви уявляєте, що робить бот після пробудження.

Саме тому Rakazo слід розміщувати на VPS (virtual private server), а не на настільному комп’ютері. Бот, який зберігає пам’ять і виконує заплановані завдання, має бути доступним, поки ви спите. Якщо ноутбук переходить у режим сну, черга перестає оброблятися.

Станом на October 2026 Rakazo і далі називає себе beta, хоча тепер публікує релізи зі стабільними номерами, тому сприймайте цю інструкцію як опис робочого налаштування, а не завершеного appliance. Увесь стек написаний на TypeScript: React 19 і Vite для web app, Hono для API, Postgres із Prisma, Better Auth для облікових записів і Graphile Worker для фонових завдань. Graphile Worker зберігає свою чергу в Postgres, тому Redis і додаткове сховище даних запускати не потрібно. .env.example встановлює WAKEUP_DRIVER=graphile, тобто пробудження бота є завданням, яке зберігається в Postgres. Якщо зупинити Postgres, разом із ним припиняться всі заплановані дії ботів. Якщо ви хочете зібрати агента з окремих компонентів, а не запускати готовий продукт, створення власного агента з компонентів — альтернативний шлях.

Чому тариф на 1 GB цього не витримає

Порахуйте процеси. Postgres — один процес. API — процес Node. Worker — другий. Вебзастосунок — третій. Supervisor sandbox — четвертий. Далі йде комп’ютер ботів: за замовчуванням це один спільний контейнер Team Computer із графічним робочим столом Linux, окремим X-дисплеєм і процесом Chrome для кожного активного бота.

У документації проєкту для self-hosting більше не вказано розмір хоста. У документі за адресою v0.3.5, перевіреному 27 October 2026, наведено лише вимоги до програмного забезпечення. Водночас там указано обмеження для кожного комп’ютера: у Docker sandboxes RAKAZO_COMPUTER_MEMORY за замовчуванням дорівнює 2g, а RAKAZO_COMPUTER_CPUS — 2. Це обмеження застосовується до кожного комп’ютера, а не до кожного бота. Кожен workspace за замовчуванням отримує один Team Computer, і всі активні Team bot запускають свої робочі столи та браузери всередині нього, тому спільно використовують ці 2 GB і два ядра. Лише бот, переміщений до Private Computer, отримує власний контейнер і власне обмеження. Установіть SANDBOX_PROVIDER=docker, і ці робочі столи працюватимуть на вашому VPS додатково до control plane, тому 4 GB — це мінімум, а не цільовий показник. Почніть із 8 GB, якщо плануєте залишати активними більше одного бота, збільште RAKAZO_COMPUTER_MEMORY, щоб спільний комп’ютер міг використовувати весь цей обсяг пам’яті, і вимірюйте фактичне споживання за допомогою docker stats, поки боти працюють. Саме браузер усередині sandbox визначає споживання пам’яті, тому за специфікацією це передбачити не можна. Щоб невеликий сервер не запускав надто багато браузерів одночасно, установіть додатне значення SANDBOX_TEAM_SCREEN_LIMIT, яке обмежує кількість активних робочих столів на Docker Team Computer. У комплектному 0 це обмеження вимкнено. Якщо пам’яті загалом мало, RAKAZO_COMPUTER_MEMORY також приймає менше значення, наприклад 1536m. Загальний метод визначення конфігурації сервера для роботи агентів докладно описано в матеріалі скільки RAM і CPU насправді потрібно VPS агента.

Одне налаштування не дає ситуації погіршуватися. .env.example постачається зі значенням SANDBOX_IDLE_MS=600000, а його коментар повідомляє, що комп’ютери призупиняються або зупиняються після вказаної кількості мілісекунд бездіяльності. Після десяти хвилин бездіяльності комп’ютер зупиняється. Мінімальне допустиме значення — 30000, а 0 вимикає автоматичне призупинення через бездіяльність. У тому самому коментарі для Docker self-hosting рекомендовано значення 0, оскільки бездіяльний комп’ютер нічого не коштує, тому довготривалі застосунки та сесії залишаються активними. Це стосується витрат, але не пам’яті. На невеликому VPS залиште таймер увімкненим, бо без нього кожен запущений вами комп’ютер і кожен браузер усередині нього продовжуватимуть працювати.

Диск також має значення. Образ sandbox, модулі Node і том Postgres використовують один диск, тому 40 GB — це розумна початкова конфігурація.

Зафіксуйте версію перед клонуванням

Rakazo швидко розвивається, а main не є релізом. Станом на 9 November 2026, v0.8.0, опублікований 4 November 2026, позначений як Latest. У цьому посібнику зафіксовано v0.3.5, опублікований 25 October 2026.

git clone https://github.com/elie222/rakazo.git
cd rakazo
git checkout f31e3c0699f086d663637c4107858c238a086fb3
git log -1 --format='%H %ci'

Це той коміт, на який вказує v0.3.5. Зафіксуйте саме коміт, а не гілку або тег. Гілка зміниться під час наступного git pull, а тег є змінною міткою, яку мейнтейнер може перенаправити на інший коміт, тому жоден із них не ідентифікує дерево, до якого можна повернутися. Ідентифікатор коміту не змінюється. Запишіть його разом з іншими параметрами сервера, оскільки після невдалого оновлення найпростішим виправленням є git checkout <old commit> і повторне збирання, а це працює лише тоді, коли відомо, який коміт був робочим. У зафіксованому README Rakazo названо beta, тому точна фіксація версії варта невеликих зусиль. Проєкт із тривалою історією продуманих релізів можна натомість зафіксувати на опублікованому тезі. Саме так зроблено в меншому self-hosted стеку на зразок openGym.

Вимоги: Node 22, pnpm 9 і Docker

node -v
pnpm -v
docker --version

package.json оголошує "engines": { "node": "^22.22.2 || ^24.0.0 || >=26.0.0" } і "packageManager": "pnpm@9.15.0". Тому node -v має вивести v22.22.2 або пізнішу версію 22.x, будь-яку v24 або v26 і новішу версію. Версія v22, старша за 22.22.2, не входить до цього діапазону, а README прямо зазначає, що Node.js 23.x і 25.x не підтримуються. Встановіть підтримувану версію Node з NodeSource або за допомогою nvm. Corepack постачається з Node 22 і 24; у Node 26 і новіших версіях спочатку встановіть його командою npm install -g corepack. Потім активуйте pnpm:

corepack enable
corepack prepare pnpm@9.15.0 --activate

Docker Engine разом із compose plugin забезпечує решту вимог. Документація для self-hosting вимагає Docker Engine версії 26 або новішої та API версії 1.45 або новішої для підшляхів томів home бота, а також curl і OpenSSL. Ваш користувач також має мати доступ до daemon. Якщо docker ps повертає permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock, додайте користувача до групи docker і відкрийте нову login shell. Спочатку врахуйте, які права це надає: членство в docker рівнозначне root на машині, оскільки будь-хто з цієї групи може запустити контейнер, змонтований до файлової системи хоста.

Налаштуйте .env, потім запустіть Postgres

cp .env.example .env
chmod 600 .env

Перед запуском потрібно змінити кілька значень. .env.example містить BETTER_AUTH_SECRET=replace-with-32-plus-character-secret, ENCRYPTION_KEY=replace-with-64-random-hex-characters, SCREEN_PROXY_SECRET=replace-with-32-plus-character-screen-proxy-secret і SANDBOX_SUPERVISOR_TOKEN=replace-with-32-plus-character-supervisor-token, а POSTGRES_PASSWORD та POSTGRES_APP_PASSWORD залишає порожніми. Усі ці заповнювачі опубліковані в репозиторії, тому розгортання, у якому залишився хоча б один із них, використовує секрет, доступний кожному. Задайте для кожного окреме випадкове значення. ENCRYPTION_KEY має містити 64 випадкові шістнадцяткові символи. Саме їх виводить openssl rand -hex 32. Для інших секретів потрібно щонайменше 32 символи, тому виконайте рядок із base64 по одному разу для кожного секрету. Для двох паролів Postgres документація self-host вимагає значення, безпечні для URL. Їх виводить останній рядок, тому також виконайте його по одному разу для кожного пароля. База даних має два облікові записи. DATABASE_MIGRATION_URL містить postgres://rakazo:REPLACE_WITH_POSTGRES_PASSWORD@127.0.0.1:5433/rakazo — власника, від імені якого виконуються міграції, а DATABASE_URL — postgres://rakazo_app:REPLACE_WITH_POSTGRES_APP_PASSWORD@127.0.0.1:5433/rakazo, власний обліковий запис застосунку без прав суперкористувача, для якого застосовується row-level security. Запишіть кожен пароль у відповідний URL. pnpm db:migrate створює обліковий запис rakazo_app із заданим паролем.

openssl rand -base64 48
openssl rand -hex 32
openssl rand -hex 24

Після цього окремо запустіть базу даних і виконайте міграції.

docker compose --env-file .env -f infra/compose/docker-compose.yml -f infra/compose/docker-compose.postgres-host.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:build

pnpm sandbox:build збирає image комп’ютера бота, визначений у package.json як docker build -t rakazo/computer:local infra/sandboxes/computer. Це графічний image, тому під час першої збірки завантажується багато даних і процес триває довше. Перевірте результат за допомогою docker image ls rakazo/computer. Команда має вивести один рядок.

Базовий compose-файл взагалі не публікує порт Postgres. Overlay docker-compose.postgres-host.yml у цій команді публікує його як 127.0.0.1:5433, доступний лише через loopback. Тому до нього можуть підключатися інструменти на хості, наприклад pnpm db:migrate і pnpm dev. Залиште це налаштування без змін. Compose не запускає Postgres без POSTGRES_PASSWORD у .env, але порт Postgres, доступний з інтернету, створює ризик атак перебором паролів. Production compose-файл читає ту саму змінну і не публікує порт бази даних.

Перший запуск

pnpm dev

Ця команда запускає чотири компоненти: API на порту 3100, Graphile Worker, вебзастосунок Vite на порту 5173 і supervisor sandbox за замовчуванням на порту 7091. Якщо ці порти зайняті, pnpm dev вибирає інший вільний блок і виводить URL. За замовчуванням застосунок доступний за адресою http://127.0.0.1:5173, де має відобразитися сторінка входу.

На VPS ви не працюєте безпосередньо на цій машині й не повинні публікувати порт 5173 для доступу до неї. Натомість перешліть порти через SSH (secure shell) зі свого комп’ютера.

ssh -L 5173:127.0.0.1:5173 -L 3100:127.0.0.1:3100 you@your-server

Зверніть увагу на різницю між способами запуску. pnpm dev запускає Vite на хості, прив’язуючи його локально. Сервіс web у файлі compose для розробки публікує 127.0.0.1:5173:5173, а його сервіс api — 127.0.0.1:3100:3100; обидва доступні лише через loopback, тому для них працює той самий тунель. У production-файлі вебзастосунок не публікує порт хоста і відкриває порт 5173 лише для контейнерів у власних мережах, а Caddy самостійно публікує порти 80 і 443. Тому для всього, що має залишатися запущеним, використовуйте production-файл і його reverse proxy.

Який sandbox provider безпечно використовувати на сервері?

Це єдине налаштування, яке потрібно виконати правильно. SANDBOX_PROVIDER у .env за замовчуванням має значення docker, а зафіксований checkout також підтримує Railway поряд із провайдерами, переліченими в self-host doc.

  • docker — значення за замовчуванням. Bot computers працюють як контейнери на вашій машині. Їх створюють з image pnpm sandbox:build і запускають під керуванням supervisor. За замовчуванням bots одного workspace спільно використовують один Team Computer, а bot отримує власний container лише на Private Computer. Обліковий запис E2B не потрібен.
  • e2b запускає bot computers в E2B і потребує E2B_API_KEY. У v0.3.5 factory приймає його у production, якщо ключ передано, без обмеження NODE_ENV. У self-host doc його названо придатним для public або multi-user production, оскільки bot computers залишаються окремо від host, на якому працюють ваш API і database.
  • daytona, createos і boat — це додаткові remote providers. Кожен потребує власного ключа: DAYTONA_API_KEY, CREATEOS_SANDBOX_API_KEY або BOAT_API_KEY.
  • railway запускає computers у Railway і потребує RAILWAY_API_TOKEN, а також явно вибраного RAILWAY_ENVIRONMENT_ID для API та worker. Використовуйте окремий Railway project або environment для sandboxes.
  • desktop запускає команди bot безпосередньо на host API та worker, як зазначено в документації. У v0.3.5 API та worker відмовляються його запускати, якщо NODE_ENV не має значення development або test, але .env.example постачається з NODE_ENV=development, тому сервер із pnpm dev усе ще його приймає. Не вмикайте його в public або shared service.
  • fake — це emulator лише для verification. Це не runtime.
  • none запускає product взагалі без computer host.

Сприймайте це буквально. У desktop mode немає жодної межі ізоляції. Тому bot виконує shell commands від імені користувача, який запускає API process, і має доступ до home directory цього користувача, його SSH keys, cloud credentials і його .env. Текст на web page, яку читає bot, стає командою на вашому сервері. Desktop mode на сервері — це спосіб дозволити bot отримати ваші credentials. Використовуйте його лише на машині, за якою ви працюєте фізично, або не використовуйте взагалі. Перемикання providers додає container навколо цього web page path, але не усуває проблему, а надання bot власного SearXNG search backend закриває таку саму injection surface з боку пошуку.

docker створює реальну межу між bots і вашим host, але слабку межу між самими bots. За замовчуванням вони спільно використовують один Team Computer. У документі про computer runtime зазначено, що Team bots спільно використовують OS user, workspace, browser profiles, а також shell і X11 access, і що окремі папки bot організовують роботу, але не є security boundaries. Тому будь-який Team bot може читати файли іншого Team bot. Bot, якому потрібна власна ізоляція, слід розмістити на Private Computer. Docker provider запускає його як окремий сусідній container у власній network. Однак supervisor, який створює ці containers, монтує /var/run/docker.sock. У self-host doc це сформульовано прямо: доступ до цього socket еквівалентний контролю над Docker host. Тому supervisor має залишатися приватним. .env.example розглядає SANDBOX_SUPERVISOR_TOKEN як окремий credential, відмінний від BETTER_AUTH_SECRET, який Docker sandboxes потребують поза local development. Він постачається із placeholder, який може прочитати будь-хто на GitHub. Задайте для нього власне випадкове значення. Для найсильнішої доступної тут ізоляції використовуйте e2b або надайте Rakazo окрему машину, на якій немає інших даних. Та сама логіка лежить в основі запуску coding agents у disposable VM: найдешевший спосіб пережити помилкову дію agent — використовувати машину, яка не має цінності.

Куди передавати API-ключі моделей?

Необов’язкове виставлення рахунків за кредити моделей у Rakazo залишається вимкненим, якщо не задано обидва секрети Stripe. Ключ надаєте ви. .env.example встановлює PI_DEFAULT_PROVIDER=openrouter, тому OPENROUTER_API_KEY є стандартним місцем, а ключі провайдерів працюють через той самий параметр.

Зберігайте ключ у .env і не додавайте його до жодного файлу, який ви комітуєте. Обидві команди compose у репозиторії передають --env-file .env, тому значення потрапляють у контейнери, але ніколи не записуються в YAML-файли, які відстежує git. Ви також можете залишити OPENROUTER_API_KEY порожнім і підключити модель у застосунку після реєстрації. Це ще одна причина, чому ENCRYPTION_KEY має містити справжнє випадкове значення, а не штатний заповнювач.

Перш ніж бот почне використовувати ключ, встановіть для нього ліміт витрат у провайдера. Бот, який зациклився, витрачає кошти. Rakazo також надає MAX_TOOL_CALLS_PER_TURN: задайте додатне ціле число, щоб коректно завершувати хід, який перевищив бюджет викликів інструментів, і водночас формувати фінальне повідомлення асистента. Якщо параметр не задано або він порожній, 0 не обмежує кількість викликів. Цей параметр рахує виклики інструментів, а не кошти, тому він не замінює ліміт витрат у провайдера. Дайте цьому ключу окреме ім’я, щоб можна було відкликати лише його. Якщо ви налаштовуєте це для команди, а не для себе, один шлюз OneCLI перед агентами всієї команди є іншим розв’язанням тієї самої проблеми, оскільки зберігає ключі провайдерів в одному місці, а не по одному ключу на кожного користувача.

Перехід від режиму розробки до конфігурації, яку можна залишити запущеною

У репозиторії є production Compose-файл, який запускає Postgres, API, worker, web app і Caddy для сертифікатів TLS (transport layer security), які Caddy отримує автоматично. Лише Caddy у цьому файлі публікує порти. За замовчуванням для комп’ютерів бота використовується E2B. Додатковий overlay, infra/compose/docker-compose.prod.docker.yml, запускає натомість локальні Docker-комп’ютери в тому самому стеку. У документації зазначено, що доданий ним supervisor має еквівалентні root права на хості.

sudo --preserve-env=SSH_CONNECTION DEPLOY_USER=deploy bash infra/compose/harden-host.sh
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  build --build-arg GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  up -d --wait --pull never
curl --fail https://app.example.com/health

Створіть обліковий запис deploy, доступ до якого здійснюється лише за ключем, і перед запуском скрипту переконайтеся, що можете ввійти за допомогою цього облікового запису. harden-host.sh вимикає вхід SSH за паролем і вхід root, обмежує частоту SSH-підключень, додає дозволи для SSH, HTTP і HTTPS через UFW (uncomplicated firewall), зберігаючи наявні правила для приватної мережі, а також вмикає fail2ban, автоматичне встановлення оновлень безпеки, AppArmor і правила аудиту. Скрипт відмовляється запускатися без SSH_CONNECTION, тому команда передає його через sudo. Якщо ви не підтвердите зміну з нового сеансу SSH протягом трьох хвилин, скрипт скасовує зміну firewall. Прочитайте скрипт перед запуском, оскільки він змінює спосіб входу та перезавантажує SSH. Не закривайте консоль провайдера, доки новий вхід через SSH не завершиться успішно.

Для production .env потрібно більше налаштувань, ніж для development. У документації щодо self-host наведено цей мінімум, а також секрети.

NODE_ENV=production
RAKAZO_HOST=app.example.com
BETTER_AUTH_URL=https://app.example.com
WEB_ORIGIN=https://app.example.com
API_URL=https://app.example.com
SIGNUPS_ENABLED=true
SIGNUP_ALLOWLIST=you@example.com
SANDBOX_PROVIDER=e2b
AGENT_RUNTIME=pi
WAKEUP_DRIVER=graphile
DATA_DIR=/data
RAKAZO_DEPLOY_DIR=/srv/rakazo
RAKAZO_IMAGE_TAG=local
POSTGRES_PASSWORD=<random, URL-safe>
POSTGRES_APP_PASSWORD=<random, URL-safe>
BETTER_AUTH_SECRET=<random>
ENCRYPTION_KEY=<64 random hex characters>
SCREEN_PROXY_SECRET=<random>
E2B_API_KEY=<your key>
OPENROUTER_API_KEY=<your key>

До першого up налаштуйте A-запис, що вказує на сервер. Caddy запитує сертифікат для імені, зазначеного в RAKAZO_HOST. Це ім’я має розв’язуватися в адресу цього сервера. Крім того, ззовні має бути доступний або порт 80 для перевірки HTTP, або порт 443 для перевірки TLS-ALPN. Обидві перевірки ввімкнені за замовчуванням, тому саме закриття порту 80 не перешкоджає видачі сертифіката через порт 443.

Від самого початку залиште SIGNUP_ALLOWLIST налаштованим на власну адресу. .env.example постачається з SIGNUPS_ENABLED=true. Обидва параметри зчитуються зі змінних середовища під час кожного запуску API. Тому екземпляр із публічним іменем, увімкненою реєстрацією та порожнім списком дозволів прийматиме реєстрації від будь-кого, хто його знайде. Непорожній список дозволів застосовується під час кожного запуску й замінює збережений список. Для реєстрації за списком дозволів потрібне підтвердження поштової скриньки, зокрема для першого облікового запису, тому налаштуйте доставку електронної пошти до реєстрації. Якщо електронна пошта недоступна, документація пропонує запустити систему з SIGNUPS_ENABLED=false і створити обліковий запис за допомогою наведеної серверної bootstrap-команди. Вона створює звичайний підтверджений обліковий запис без привілеїв на сервері. Спочатку налаштуйте список дозволів. За потреби пізніше послабте це обмеження. Якщо на цьому самому сервері вже працює кілька сервісів і ви хочете підтримувати один список користувачів замість окремого списку дозволів для кожного застосунку, розміщення екземпляра Authentik перед ними перенесе це рішення на рівень проксі. Водночас Authentik працюватиме перед власними обліковими записами Better Auth у Rakazo, а не замінюватиме їх.

Вважайте docs/self-host.md у репозиторії основним джерелом інформації для production-налаштувань, оскільки цей файл змінюється разом із кодом, а цей посібник — ні. Оскільки роботу виконує Compose, застосовуються звичайні правила. Основи Docker Compose для VPS пояснюють, чому --env-file і іменовані томи стають важливішими, коли стек залишають працювати без змін на кілька місяців.

Резервні копії

У цій конфігурації Postgres і каталог data/ містять дані інстансу. Для відновлення також потрібні ENCRYPTION_KEY і всі налаштовані content master keys, тому зберігайте копії за межами сервера.

./scripts/backup.sh
./scripts/restore.sh backups/BACKUP_TIMESTAMP

backup.sh створює дамп Postgres і архівує data/. restore.sh працює зі стеком розробки Compose у порожній базі даних, коли сервіси застосунку зупинені, і не читає файли резервних копій production. Для машини, від якої ви залежите, встановіть infra/compose/backup-prod.sh як /usr/local/sbin/rakazo-backup із таймером, який постачається разом із репозиторієм. Скрипт записує перевірений дамп і архів даних застосунку в /var/backups/rakazo, за замовчуванням зберігає до трьох перевірених знімків, кількість яких задається параметром RAKAZO_BACKUP_KEEP, у межах ліміту 50 GiB, заданого параметром RAKAZO_BACKUP_MAX_GB, і перед кожним запуском видаляє неповні знімки та зайву історію, тому ротація виконується автоматично. Він також може шифрувати кожну резервну копію за допомогою age для відкритих ключів отримувачів, перелічених у /etc/rakazo/backup.env, щоб сервер записував резервні копії, які не може прочитати. Створіть цю пару ключів на контрольованій вами машині, а приватний ключ зберігайте за межами сервера. Якщо отримувачів не вказано, резервна копія залишається незашифрованою, а в журнал записується попередження. Після створення першої зашифрованої резервної копії запуск без отримувачів завершується помилкою, якщо явно не дозволити незашифровані копії за допомогою RAKAZO_BACKUP_ALLOW_PLAINTEXT=1. Резервна копія на тому самому диску, що й база даних, не є резервною копією, тому скопіюйте її за межі сервера. Потім один раз відновіть її на резервному сервері, перш ніж вона знадобиться.

Чому це не працює і що ви побачите

pnpm db:migrate не може підключитися до бази даних. Під час міграції з’являється повідомлення, що неможливо підключитися до сервера бази даних за адресою 127.0.0.1:5433. Контейнер Postgres може бути не запущений, ще не завершити ініціалізацію або бути запущеним без overlay docker-compose.postgres-host.yml, який публікує порт 5433 на хості. Виконайте docker compose --env-file .env -f infra/compose/docker-compose.yml ps і перевірте, чи має сервіс postgres стан healthy, оскільки compose-файл виконує перевірку стану кожні три секунди. Якщо контейнер постійно перезапускається, перегляньте його журнали: закріплений стек Compose відмовляється запускатися на старому томі Postgres 16, доки його не буде мігровано до Postgres 18. docker compose ... down -v очищає цей том разом із даними.

Порт уже використовується. Запуск Postgres завершується помилкою bind: address already in use, якщо порт 5433 уже зайнятий іншим процесом. Найчастіше це попередній стек Rakazo, який ви не зупинили. sudo ss -lntp | grep 5433 показує назву процесу. Overlay читає порт хоста зі змінної POSTGRES_HOST_PORT, тому його можна змінити, але разом із ним потрібно змінити DATABASE_URL і DATABASE_MIGRATION_URL.

Бот не отримує комп’ютер. Якщо задано SANDBOX_PROVIDER=docker, але відсутній образ rakazo/computer:local, запускати нічого. docker image ls rakazo/computer показує це однорядковою відповіддю, а pnpm sandbox:build виправляє проблему. Якщо supervisor не може отримати доступ до Docker socket, він також не може створювати контейнери. Повідомлення містить шлях: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

Довга команда завершується посеред виконання. .env.example встановлює SANDBOX_COMMAND_TIMEOUT_MS=300000, тому одну команду всередині комп’ютера бота буде примусово завершено через п’ять хвилин. Для повільних збірок збільште це значення, а не припускайте, що sandbox аварійно завершив роботу.

pnpm install працює непередбачувано. Спочатку перевірте node -v. У workspace оголошено ^22.22.2 || ^24.0.0 || >=26.0.0, тому версії 23.x, 25.x і будь-яка версія 22.x до 22.22.2 не відповідають цій вимозі. Закріплений .npmrc встановлює engine-strict=true, тому pnpm install відхиляє непідтримувану версію Node з помилкою engine/version ще до виконання коду залежностей застосунку.

Вхід працює локально, але не через домен. BETTER_AUTH_URL, WEB_ORIGIN і API_URL мають містити те саме публічне origin, що й адресний рядок, включно зі схемою. Застаріле http://127.0.0.1:5173, яке залишилося в одному з них, зазвичай спричиняє проблему, коли сесія не зберігається.

Оновлення checkout із зафіксованою версією

У посібнику для self-host production Compose stack, зібраного з вашого checkout, описано короткий шлях оновлення: отримайте новий вихідний код, а потім перебудуйте й перезапустіть API, worker і web app. Міграції запускаються під час старту API, оскільки його команда запуску застосовує їх до початку обробки запитів.

sudo /usr/local/sbin/rakazo-backup
git fetch --all --tags
git checkout NEW_COMMIT_SHA
export GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
  up -d --wait --pull never --build api worker web

Спочатку створіть резервну копію. Міграції виконуються лише вперед, а beta-версія не дає гарантованого способу повернення. Якщо ваш checkout старіший за 30 August 2026, зокрема містить коміт v0.1.0-beta, перед оновленням прочитайте примітку в посібнику про міграцію 20260830200000_space_scope_names_and_user_credentials. Це узгоджене перемикання, тому спочатку зупиніть старі API і worker та виконайте перевірку межі приватності Space, наведену в посібнику. Під час оновлення з checkout, що передує появі окремого входу в застосунок, задайте POSTGRES_APP_PASSWORD у .env перед перебудовою; production compose file не запускається без цього параметра. Файли source-checkout і production Compose також використовують Postgres 18: наявна інсталяція Postgres 16 потребує процедури infra/compose/upgrade-postgres.sh з посібника, перш ніж її можна буде запустити в новій структурі. Перед застосуванням змін прочитайте коміти між вашим зафіксованим SHA і новим SHA, оскільки такий молодий проєкт може перейменовувати змінні середовища без попередження, а відсутня змінна проявляється як сервіс, який запускається, а потім завершує роботу. Якщо ви ще вирішуєте, чи варто взагалі запускати Rakazo, огляд self-hosted AI-агентів описує інші рішення цієї категорії та вартість їх підтримки.

FAQ

Чи можна запустити Rakazo на VPS із 1 GB пам’яті?

Ні. Postgres, API, worker, supervisor sandbox і вебзастосунок працюють одночасно. У режимі SANDBOX_PROVIDER=docker комп’ютер ботів додатково запускає контейнер із графічним робочим столом, окремим X display і процесом Chrome для кожного активного бота. Усе це працює в межах стандартного обмеження 2 GB пам’яті та двох CPU. У self-host документації за адресою v0.3.5 вимоги до розміру хоста не вказані. Вважайте 4 GB мінімальним обсягом для control plane і використовуйте більше, якщо робочі столи запускаються на вашій машині.

Чи безпечний desktop sandbox provider на сервері?

Ні. У self-host документації зазначено, що desktop виконує команди безпосередньо на хості API і worker. Тому бот працює від імені користувача, який запустив цей процес, і має доступ до файлів та облікових даних цього користувача. У режимі v0.3.5 API і worker відхиляють його за межами режимів development і test, але сервер із pnpm dev працює в режимі development і приймає його. Не використовуйте його на публічному або спільному сервері. Використовуйте docker, щоб надати боту Private Computer, коли він не повинен спільно використовувати файли з іншими ботами workspace, або e2b, якщо входити мають більше однієї особи.

Яку версію Rakazo потрібно встановити?

Станом на 9 November 2026 найновішим релізом є v0.8.0, опублікований 4 November 2026 і позначений як Latest. Щоб дотримуватися цього посібника, переключіться на зафіксований коміт v0.3.5 — f31e3c0699f086d663637c4107858c238a086fb3, а не відстежуйте main або серпневий prerelease v0.1.0-beta. Гілка змінюється під час роботи, а тег може бути перенаправлений на інший коміт, тому жоден із них не ідентифікує дерево, до якого можна повернутися. Запишіть коміт, оскільки відкат можливий лише тоді, коли відомо, який коміт був робочим.

Де зберігати мій OpenRouter API key?

У .env як OPENROUTER_API_KEY, але ніколи не додавайте його до compose-файлу, який комітите. Обидві compose-команди в репозиторії передають --env-file .env, тому значення потрапляє до контейнерів, але не записується у version-controlled YAML. Також можна залишити це поле порожнім і підключити модель у застосунку після реєстрації. Встановіть ліміт витрат для ключа у провайдера, оскільки бот у циклі продовжуватиме викликати модель, доки щось його не зупинить.

Чи потрібні доменне ім’я та TLS?

Для всього, що виходить за межі першого тесту, так. Production compose-файл запускає Caddy і автоматично отримує сертифікати. Встановіть RAKAZO_HOST у значення публічного hostname, а BETTER_AUTH_URL, WEB_ORIGIN і API_URL — у те саме публічне HTTPS-джерело. Для першої перевірки домен можна не налаштовувати: запустіть pnpm dev і перешліть порт 5173 через SSH замість його публікації.

Чи була ця стаття корисною?