Як self-host open-kritt запустити на VPS
Налаштуйте open-kritt на VPS через Docker Compose: зафіксуйте release, відкрийте UI через SSH tunnel на port 5173 і задайте бюджет провайдера.
Чому self-host open-kritt варто запускати на VPS, а не на ноутбуці
Запускайте self-host open-kritt на сервері, який можна знищити й відновити. Інструмент запускає свої аналітичні агенти від імені root усередині одноразових job-контейнерів, надає кожному з них доступну для запису копію коду та прямий доступ до інтернету, а також монтує Docker socket хоста у свій engine service. На сервері, виділеному для цього завдання, це прийнятний компроміс. На машині, де зберігаються ваші SSH-ключі, це небезпечно.
Цю рекомендацію визначають чотири властивості стандартної конфігурації. Усі чотири випливають із власних README і compose-файлу проєкту.
Агенти мають широкі повноваження. У README зазначено, що агенти з увімкненими інструментами працюють від імені root усередині одноразових job-контейнерів, мають доступні для запису копії репозиторіїв і прямий доступ до інтернету. Тому вони можуть встановлювати інструменти, компілювати цілі, запускати тести та створювати proof of concept. Сканування — це не робота linter, який лише читає файли. Це довільне виконання коду, яке ви дозволили. Доступ до інтернету створює ризики в обох напрямках: будь-які дані, які агент отримує під час дослідження цілі, є недовіреним текстом, що потрапляє до його prompt. Це той самий ризик, який виникає, коли ви надаєте агенту власний вебпошук.
Engine має доступ до Docker socket. docker-compose.yml монтує Docker socket хоста у engine service, оскільки engine створює та запускає окремий контейнер сканування для кожного завдання. Будь-який процес, який може звернутися до цього socket, може запустити контейнер із змонтованою файловою системою хоста. Отже, engine фактично має повноваження root на хості, де він працює.
Екрана входу немає. Backend постачається без автентифікації застосунку. Доступ до порту означає доступ до результатів сканування та кредитів вашого провайдера.
Код, який ви скануєте, часто вам не належить. Якщо передати агентам сторонній репозиторій, вони збиратимуть цей репозиторій на вашій машині від імені root і з доступом до мережі.
Якщо ви прочитали чому coding agents мають працювати в одноразовій VM, то це та сама модель загроз, але з вищим рівнем ризику. Виділіть для open-kritt окремий VPS, на якому більше нічого немає, і керуйте цим VPS через окремий обліковий запис із мінімальними привілеями, а не від імені root.
Що насправді робить open-kritt
open-kritt (репозиторій — Kritt-ai/open-kritt, ліцензія AGPL-3.0) розбиває дослідження вразливостей на невеликі завдання, паралельно запускає їх на AI-агентах, а потім усуває дублікати та ранжує отримані результати. Ви визначаєте workflow як ланцюжок сфокусованих промптів, і кожен крок отримує структурований контекст із попередніх кроків. Ціллю сканування є віддалений або локальний git-репозиторій. Механізмом аналізу може бути Codex або Claude Code. Після появи кандидата додаткові post-script можуть спробувати перевірити його або створити proof of concept. Проєктування такого ланцюжка є звичайною роботою з агентами, а не роботою з безпеки. Тому якщо промпти, інструменти та передавання контексту ще недостатньо знайомі, вивчення принципів побудови агентів принесе більше користі для результатів, ніж будь-яке налаштування з цього посібника.
У результаті ви отримуєте ранжований список кандидатів. Розглядайте його як чергу для первинного аналізу, а не як звіт.
Що потрібно підготувати
- VPS з Ubuntu 24.04, Debian 12 або Rocky Linux 9. В інструкції зі встановлення ці дистрибутиви зазначені як перевірені для архітектур x86_64 і ARM64.
- Docker Engine із плагіном Compose.
- Node.js 20 або новішої версії на хості, оскільки CLI
./krittпрацює на хості, а не всередині контейнера. - Один постачальник моделей: обліковий запис Codex або
OPENAI_API_KEY,CODEX_API_KEY,ANTHROPIC_API_KEYчиOPENROUTER_API_KEY. GITHUB_TOKENпотрібен лише для сканування приватних репозиторіїв. У складі.env.exampleце чітко зазначено: одного токена GitHub недостатньо для запуску сканування.
Спочатку встановіть Docker і Node 20
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USERВийдіть із системи та увійдіть знову, щоб застосувалося нове членство в групі, а потім перевірте наявність плагіна Compose.
docker compose versionРядок версії означає, що Compose встановлено як плагін. docker: 'compose' is not a docker command означає, що натомість у вас є старий окремий бінарний файл docker-compose, а open-kritt викликає docker compose. Членство в групі docker фактично надає права root на хості, тому додайте до неї лише обліковий запис, від імені якого запускається open-kritt. Розширений опис цього налаштування див. у розділі запуск Docker на VPS.
Ubuntu 24.04 постачається з Node 18 у власному репозиторії, а CLI завершує роботу з будь-якою версією нижче 20. Node 20 уже досяг кінця життєвого циклу й більше не отримує оновлень, тому встановіть Node 22 із NodeSource. Він відповідає тій самій перевірці «20 або новіша».
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -vnode -v тут має вивести v22., а будь-яка версія нижче v20. буде відхилена CLI. У Rocky Linux 9 еквівалентом є sudo dnf module enable nodejs:22 -y, а потім sudo dnf install -y nodejs.
Клонуйте open-kritt і зафіксуйте позначений реліз
git clone https://github.com/Kritt-ai/open-kritt
cd open-kritt
git fetch --tags
git tag --list
git checkout v1.4.1main змінюється. Позначений реліз — ні. Станом на 12 October 2026 найновішою позначкою є v1.4.1, опублікованою 16 August 2026, а git tag --list показує, що доступно на момент клонування. У v1.4.0 (12 August 2026) додали врахування доступної пам’яті під час допуску runner, описане нижче в розділі про визначення розміру. У v1.4.1 виправили помилку, через яку ranker ігнорував задані користувачем правила ранжування. Перехід на позначку переводить репозиторій у стан detached HEAD. У цьому випадку це правильно: ви використовуєте цей клон як розгортання з фіксованою версією, а не як гілку, до якої вносите коміти. Щоб пізніше оновити версію, прочитайте release notes, потім виконайте git fetch --tags, перейдіть на нову позначку та знову виконайте ./kritt start, оскільки start перебудовує images.
Не запускайте ./kritt разом із sudo. У документації це прямо зазначено. CLI керує локальними для проєкту каталогами облікових даних у .data/, тому запуск від імені root залишає ці каталоги належними користувачу root, і під час наступного звичайного запуску запис до них неможливий.
Налаштуйте доступ до моделей за допомогою ./kritt setup
./kritt setupКоманда створює .env з .env.example, якщо цього файлу ще немає, виводить стан кожного облікового даного та дає змогу встановлювати або видаляти їх. Значення ніколи не виводяться назад у термінал. І .env, і файл облікових даних рушія записуються з режимом 0600.
Якщо ви хочете виконати це вручну:
cp .env.example .env
chmod 600 .env
mkdir -p .data/codex
chmod 700 .data/codexПотім додайте ключ провайдера у .env і залиште файл із режимом 0600. У будь-якому разі на цьому сервері тепер зберігаються чинні облікові дані провайдера. Це ще одна причина не розміщувати на сервері нічого іншого. Створіть ключ лише для цього проєкту, щоб його відкликання згодом не порушило роботу потрібних вам ресурсів. У матеріалі Не дозволяйте AI-агентам отримувати доступ до секретів описано ширший підхід.
Установіть ліміт витрат у провайдера перед першим скануванням
open-kritt розрахований на паралельний запуск багатьох завдань, і саме за цю паралельність ви платите. Значення за замовчуванням у .env.example для v1.4.1 є консервативними: ENGINE_WORKER_COUNT=2, описане у файлі як консервативне значення за замовчуванням для невеликої машини з 2 vCPU, і ENGINE_MAX_CONCURRENT_SCANS=1. Вище розташовані ENGINE_WORKERS_PER_ACCOUNT=15 — максимальна кількість одночасних викликів root model, дозволена для одного облікового запису провайдера, — і ENGINE_CODEX_MAX_SUBAGENTS_PER_SESSION=5, оскільки сеанс Codex може запускати до п’яти дочірніх агентів. Якщо збільшити кількість worker на потужнішому VPS, відповідно зросте й кількість одночасних викликів model.
У репозиторії немає обмеження суми витрат. У .env.example немає параметра бюджету. Власні умови зупинки engine — це ліміти worker і ENGINE_HARNESS_TIMEOUT_SECONDS, для якого за замовчуванням встановлено 7200 секунд на один запуск harness. Тут harness — це цикл, який продовжує викликати model із tools і context, доки щось не завершить запуск. Тому цей timeout обмежує час роботи програми-обгортки навколо model, а не суму, яку model може витратити під час цього запуску. Отже, верхню межу потрібно встановити на стороні провайдера. Відкрийте консоль провайдера та встановіть жорсткий місячний ліміт до першого сканування, а не після нього. У матеріалі Як контролювати витрати AI-агента на VPS описано налаштування для кожного провайдера.
Є також локальний запобіжник. Встановлення ENGINE_WORKER_COUNT=0 призупиняє отримання нових завдань. Ті самі значення worker можна змінити на екрані Settings після запуску stack.
У цьому посібнику не наведено ціну одного сканування, оскільки вартість залежить від розміру репозиторію, workflow, який ви створюєте, і model, що працює за ним. Виконайте одне сканування для одного невеликого репозиторію, а потім перевірте сторінку використання ресурсів у провайдера, перш ніж запускати сканування для великого репозиторію.
Запустіть стек і перевірте його стан
./kritt startЦя команда перевіряє .env і принаймні один обліковий ключ, а потім запускає docker compose up --build. Перше складання виконується повільно, оскільки створює образи frontend, backend, engine, executor view і database. Команда також працює у foreground, тому після закриття SSH-сеансу стек зупиниться. Запускайте його всередині tmux або після успішного першого складання запустіть у detached-режимі. Жоден із цих варіантів самостійно не переживає перезавантаження. Якщо потрібно, щоб стек запускався після перезавантаження сервера, шаблон unit для systemd з розділу як забезпечити роботу self-hosted agent після перезавантажень підходить без змін.
docker compose up -d --build
docker compose psdocker compose ps має показати open-kritt-frontend, open-kritt-backend, open-kritt-engine, open-kritt-executor-view і open-kritt-db. Потім перевірте, чи backend відповідає на самому сервері.
curl -s http://127.0.0.1:3002/api/healthВідповідь у форматі JSON означає, що backend працює. Failed to connect to 127.0.0.1 port 3002: Connection refused означає, що він не працює, а docker compose logs backend покаже причину. Зупиніть усі компоненти командою docker compose down з каталогу репозиторію.
Додатково можна виконати docker compose exec backend npm run seed, щоб завантажити демонстраційні дані. Це простий спосіб переглянути інтерфейс, перш ніж витрачати кошти на реальне сканування.
Отримуйте доступ до UI на порту 5173 через SSH-тунель
Кожен сервіс у compose-файлі за замовчуванням прив’язаний до 127.0.0.1: frontend — до 5173, backend — до 3002, executor view — до 8090, а Postgres — до 5432. Не змінюйте ці прив’язки. Перенаправте порт через SSH зі свого комп’ютера.
ssh -N -L 5173:127.0.0.1:5173 you@your-server-ipПоки ця команда виконується, відкрийте http://localhost:5173 у локальному браузері. -N означає, що з’єднання передає перенаправлений порт і не відкриває shell. Якщо потрібен також executor view, додайте до тієї самої команди другий -L 8090:127.0.0.1:8090.
Є спокуса встановити FRONTEND_BIND_ADDRESS=0.0.0.0 і не використовувати тунель. Не робіть цього. У backend немає екрана входу, тому будь-хто, хто отримає доступ до цієї сторінки, зможе запускати сканування та витрачати кошти вашого провайдера. Для порівняння, Vaultwarden розрахований на роботу в інтернеті, а його захист зводиться до admin token і backup file, тобто до механізмів, яких open-kritt не надає. Є й інша проблема: опублікований порт контейнера обробляється до застосування політики за замовчуванням ufw, тому правило ufw deny 5173 виглядає правильним, але нічого не блокує. У матеріалі Порти Docker, які обходять ufw показано ланцюжок правил, через який це відбувається.
Розмір VPS
ENGINE_MIN_FREE_STORAGE_GB має значення 20 за замовчуванням. Якщо вільного сховища менше, engine не запускає новий контейнер для окремого job. Built images, checkout cache, дані Postgres і робочі каталоги job зберігаються на одному диску, тому VPS на 20 GB взагалі не запускає сканування. Вважайте 40 GB мінімальним обсягом. Для великих repository потрібен більший диск. Не намагайтеся вивільнити ресурси, розмістивши поруч сервіс із високим споживанням сховища. Виміряні мінімальні вимоги до RAM і диска в цьому порівнянні PhotoPrism та Immich показують, як швидко медіатека використає запас, потрібний для сканування. Те саме стосується додаткових компонентів, які здаються маловитратними поруч зі scanner: browser front end, що стилізує бібліотеку Jellyfin під відеопрокат 90-х усе одно додає на диск повноцінний media server і його transcodes. Тому розміщуйте його на іншому host.
Потребу в пам’яті можна визначити простим розрахунком. Відповідні settings з’явилися у v1.4.0, тому вони застосовуються до tag, закріпленого вище, але не до старіших tag. ENGINE_MEMORY_RESERVE_GB=2 резервує пам’ять для engine, database, API і короткочасних накладних витрат. Кожен scan runner додатково має soft reservation ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB=1536 і hard cap ENGINE_SCAN_RUNNER_MEMORY_MB=1536. Тому двом worker потрібно приблизно 5 GB ще до запуску інших компонентів. Engine допускає лише ті runner, які вміщуються в доступний бюджет. На невеликому host сканування стають у чергу, а не завершується помилкою. Це значно кращий сценарій, ніж спрацювання out-of-memory killer. Такий самий розрахунок визначає мінімальні вимоги для будь-якого інструмента, який запускає окремий container для кожної одиниці роботи. Саме тому один container і browser OpenBot для кожного AI coworker упирається в обмеження RAM задовго до обмеження CPU.
Два prune settings за замовчуванням мають значення true: ENGINE_AUTO_PRUNE_DOCKER_BUILD_CACHE і ENGINE_AUTO_PRUNE_UNUSED_DOCKER_IMAGES. Після завершення task engine видаляє невикористаний build cache, невикористані images і зупинені scan containers. Images, на які посилається будь-який container, service containers, bind mounts, дані database, credentials і volumes зберігаються. Це ще одна причина не використовувати спільний host: pruner, який ви не налаштовували, працює з цим Docker daemon.
Налаштування engine, які найчастіше змінюють
ENGINE_WORKER_COUNT: загальна кількість worker slots, спільних для scan steps і post-processing. Встановіть 0, щоб призупинити отримання нових job.ENGINE_MAX_CONCURRENT_SCANS: кількість scans, які можна виконувати одночасно. Queued scans очікують, доки active pool не звільниться.ENGINE_MAX_WORKERS_PER_SCAN: значення 0 рівномірно розподіляє aggregate slots між scans.ENGINE_HARNESS_TIMEOUT_SECONDS: за замовчуванням 7200. Це максимальна тривалість одного job, який не завершився. Engine приймає значення від 60 до 86400. Для будь-якого значення поза цим діапазоном, зокрема 0, використовується 7200.ENGINE_MIN_FREE_STORAGE_GB: мінімальний обсяг вільного сховища.ENGINE_IGNORE_LOW_STORAGE=trueвимикає захист. У file зазначено, що це може заповнити диск host.ENGINE_SCAN_RUNNER_MEMORY_MB: hard memory cap для кожного runner. Значення 0 прибирає обмеження.ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB: soft reservation для кожного runner, яку враховує admission control. Зменшення цього значення overcommits вільну пам’ять, тоді як hard cap і надалі обмежує пікове споживання.
Сканування локального репозиторію без його витоку
LOCAL_REPOS_PATH має типове значення ./local_repos і монтується в контейнери backend та engine як доступний лише для читання bind mount. Тому репозиторій, який ви помістите в цю папку на хості, одразу стане доступним усередині контейнерів. Використовуйте свіжий клон, а не робочу копію. Контейнер завдання отримує доступну для запису копію, працює від імені root і має вихід в Інтернет. Це означає, що будь-які дані в цій копії можна змінити або передати за межі сервера. Перед копіюванням проєкту видаліть файли .env і приватні ключі.
Що ви отримаєте, а чого не отримаєте
Ви отримаєте ранжовані потенційні знахідки. Ви не отримаєте підтверджені вразливості. Ранжування та усунення дублікатів визначають порядок у вашій черзі тріажу. Вони не доводять, що запис є справжнім. Post-scripts можуть спробувати виконати перевірку та створити proof of concept. Це найсильніший сигнал, який надає інструмент. Але невдале виконання post-script не доводить, що знахідка хибна. Людина все одно перевіряє кожну потенційну знахідку. Саме через цю різницю між потенційною знахідкою та доказом варто скористатися підходом запитувати в агента докази, які ви можете самостійно повторно перевірити: знахідка, яку можна відтворити на вимогу, цінніша за ранжовану знахідку, яку доводиться приймати на віру.
Цей посібник не стверджує, скільки реальних помилок знаходить open-kritt, оскільки ми цього не вимірювали. Той, хто наводить показник виявлення для вашої кодової бази, не запускав інструмент на вашій кодовій базі. Спочатку проскануйте репозиторій, який ви вже добре знаєте: знахідки, які ви можете оцінити самостійно, є найдешевшим доступним способом калібрування.
Авторизація тут важливіша, ніж у більшості self-hosted інструментів. Агенти компілюють і виконують код та отримують доступ до мережі, тому етап proof-of-concept може взаємодіяти з робочими системами. Використовуйте код, яким ви володієте або який маєте право тестувати за договором, і запишіть область тестування до запуску будь-яких операцій. Якщо ви налаштуєте ANTHROPIC_API_KEY і використовуєте Claude Code engine, правила безпечної роботи, описані в безпечний запуск Claude Code на VPS, також застосовуються до цих агентів.
FAQ
Навіщо open-kritt потрібен власний VPS?
Оскільки його агенти аналізу працюють від імені root у тимчасових job-контейнерах із доступними для запису копіями вашого коду та прямим доступом до Інтернету, а сервіс engine монтує Docker socket хоста, щоб запускати по одному контейнеру для кожного job. Будь-який процес, який отримує доступ до цього socket, може запустити контейнер із змонтованою файловою системою хоста, тому весь стек слід вважати таким, що має права root на хості. На виділеному VPS це прийнятний компроміс, а повторне розгортання сервера не створює проблем. На вашій основній робочій станції це поміщає SSH-ключі та профілі браузера в ту саму межу довіри, що й код, який ви скануєте.
Чи можна відкрити порт 5173 замість використання SSH-тунелю?
Не слід. Backend постачається без автентифікації на рівні застосунку, тому порт є єдиним бар’єром між Інтернетом і результатами аналізу та кредитами провайдера. Саме тому compose-файл прив’язує кожен сервіс до 127.0.0.1. Натомість виконайте ssh -N -L 5173:127.0.0.1:5173 you@your-server-ip і відкрийте http://localhost:5173 локально. Правило ufw не є заміною, оскільки опублікований Docker-порт обробляється до застосування політики ufw за замовчуванням.
Як заборонити open-kritt витрачати більше, ніж заплановано?
Перед першим скануванням установіть жорсткий ліміт у консолі вашого провайдера моделей, оскільки open-kritt не має власного налаштування бюджету. Для перших запусків залиште стандартні значення concurrency, з якими постачається система: ENGINE_WORKER_COUNT=2 і ENGINE_MAX_CONCURRENT_SCANS=1. Пам’ятайте, що один обліковий запис провайдера за замовчуванням допускає до 15 одночасних викликів root model, а сесія Codex може запускати до п’яти дочірніх агентів. ENGINE_WORKER_COUNT=0 призупиняє отримання нових job і є найшвидшим способом локально зупинити систему.
Яку версію слід отримати?
Тег, а не main. Команда git fetch --tags разом із git tag --list показує доступні версії, а v1.4.1, опублікована 16 August 2026, є найновішою станом на 12 October 2026. Фіксація версії означає, що повторне розгортання через кілька місяців створить такий самий стек. Вона також дає змогу оновлювати систему свідомо, після ознайомлення з release notes, а не випадково отримувати іншу версію під час клонування в інший день.
Сканування не запускається. Що перевірити?
Спочатку перевірте вільне місце на диску, оскільки engine не запускатиме окремий контейнер сканування для job, якщо вільного сховища менше ніж ENGINE_MIN_FREE_STORAGE_GB. Значення за замовчуванням становить 20 GB. Потім перевірте, що ENGINE_WORKER_COUNT не дорівнює 0, оскільки це значення призупиняє отримання нових job. Після цього переконайтеся, що облікові дані моделі справді налаштовані, виконавши ./kritt setup, оскільки самого GITHUB_TOKEN недостатньо для запуску сканування. docker compose logs engine вказує причину, через яку job було пропущено.