nodbox
Разделы документации

Быстрый старт

От заявки на ранний доступ до работающего адреса: создать проект, подключить код и получить первую версию из панели или фразой агенту.

Приложение с адресом и HTTPS можно получить двумя путями: из панели или фразой агенту в редакторе. Результат у них один, а готовить нужно одно и то же.

Что понадобится

  • Аккаунт. Платформа в раннем доступе: оставь заявку на console.nodbox.ru, и мы напишем, когда подойдёт очередь.
  • Баланс. Приложение создаётся, когда на балансе хватает денег содержать его хотя бы неделю. Пополнить можно от 100 ₽: Пополнение баланса.
  • Код. Репозиторий GitHub, GitLab или Bitbucket, публичный или приватный, zip-архив с папкой проекта или собранный образ. Dockerfile писать не нужно: платформа сама определяет язык, зависимости и команду запуска. Проверены Node.js, Python и Go.

Первый деплой из панели

  1. Создай проект. Проект - рабочее пространство: в нём живут приложения, базы и баланс, поэтому проект создаётся первым. На аккаунт можно завести три проекта. Что такое проект, приложение и версия, объясняет страница Основные понятия.
  2. Заполни страницу «Новое приложение». Все настройки собраны на ней, карточки идут сверху вниз:
    • «Откуда брать код» - вкладки git, образ и архив. Для репозитория подключи GitHub, GitLab или Bitbucket и выбери репозиторий и ветку: Подключение GitHub, GitLab и Bitbucket. Все три способа разобраны в разделе Источники кода
    • «Что это за приложение» - веб-приложение или воркер
    • «Имя и адрес» - у воркера карточка называется «Имя», потому что адреса у него нет
    • Переменные и секреты - настройки приложения, которые подставляются при запуске: Переменные и секреты
    • «Мощность» - размер приложения. Минимальный - Eco 256: 0,25 ядра, 256 МБ памяти, 190 ₽ за месяц круглосуточной работы. Размер меняется в любой момент: приложение переедет за один деплой, пересоздавать его не нужно. Все размеры - в разделе Размеры приложения
    • «Сон и масштаб» - сон без запросов и число экземпляров, воркер не засыпает
    • «Сколько это будет стоить» - стоимость приложения до создания
  3. Нажми «Создать приложение». Платформа создаёт приложение и сразу заказывает первую версию: отдельной кнопки деплоя нет. Лог сборки идёт на экране строка за строкой. Сборка занимает до 16 минут, дальше платформа её останавливает. Упавшая сборка работающую версию не трогает, а в логе видно, на какой строке она сломалась: Лог сборки.
  4. Открой адрес. Когда сборка закончится, приложение отвечает по HTTPS на адресе платформы. Свой домен привязывается отдельно: Свой домен.

Дальше каждый push в выбранную ветку заводит новую версию сам: Автодеплой по push.

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

Первый деплой фразой агенту

Агент деплоит теми же действиями, что доступны в панели, и только в правах своего токена. Токен выдаётся при входе через утилиту nodbox.

Установи утилиту

На macOS и Linux:

curl -fsSL https://get.nodbox.ru/install | bash

На Windows:

powershell -c "irm https://get.nodbox.ru/install.ps1 | iex"

Скрипт проверяет контрольную сумму sha256 и ставит nodbox в ~/.local/bin, а при необходимости дописывает этот каталог в профиль оболочки. Скрипт для macOS и Linux открывается по тому же адресу, так что его можно прочитать до запуска.

Войди в аккаунт

nodbox login

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

Подключи агента

nodbox mcp add

Команда прописывает nodbox в конфиг агента как MCP-сервер, то есть набор инструментов, которые агент вызывает сам: адрес сервера и токен. По умолчанию берётся текущий проект, его выбирает команда nodbox project use <id>. Другой проект задаётся флагом --project <id>. Подключение работает в Claude Code, Cursor, Windsurf, VS Code, Cline, Zed и Claude Desktop, подробности по каждому - в разделе Подключение MCP-сервера.

Скажи агенту, что делать

Открой проект в редакторе и напиши агенту:

задеплой этот проект

Агент закажет деплой, а при падении сборки заберёт лог и принесёт его в чат. Остальное делается теми же фразами:

  • «задеплой ветку release» - соберёт и выкатит новую версию
  • «привяжи домен shop.example.ru» - привяжет домен и выпустит сертификат
  • «добавь базу postgres» - поднимет управляемую базу и подставит строку подключения
  • «покажи логи за последний час» - отдаст логи прямо в чат
  • «верни предыдущую версию» - откатит на ту, что работала: код, переменные, размер

Полный список фраз - в разделе Фразы для агента.

Права агента

Вход выдаёт токен с четырьмя независимыми правами: читать, деплоить, менять мощность и удалять. Удаление по умолчанию выключено. Права проверяет платформа, а не клиент: выключенное действие агент выполнить не сможет. Токен живёт 60 суток и отзывается одним действием. Подробности - в разделе Токены и права.

Что дальше

Ошибки и куда смотреть

Страница в markdown, так её читает агент: /docs/start/quickstart.md