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

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

Раздел: Начало работы
Источник: https://nodbox.ru/docs/start/quickstart/

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

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

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

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

1. **Создай проект.** Проект - рабочее пространство: в нём живут приложения, базы и баланс, поэтому проект создаётся первым. На аккаунт можно завести три проекта. Что такое проект, приложение и версия, объясняет страница [Основные понятия](/docs/start/concepts/).
2. **Заполни страницу «Новое приложение».** Все настройки собраны на ней, карточки идут сверху вниз:
   - «Откуда брать код» - вкладки git, образ и архив. Для репозитория подключи GitHub, GitLab или Bitbucket и выбери репозиторий и ветку: [Подключение GitHub, GitLab и Bitbucket](/docs/deploy/git-accounts/). Все три способа разобраны в разделе [Источники кода](/docs/deploy/sources/)
   - «Что это за приложение» - веб-приложение или воркер
   - «Имя и адрес» - у воркера карточка называется «Имя», потому что адреса у него нет
   - Переменные и секреты - настройки приложения, которые подставляются при запуске: [Переменные и секреты](/docs/apps/env/)
   - «Мощность» - размер приложения. Минимальный - Eco 256: 0,25 ядра, 256 МБ памяти, 190 ₽ за месяц круглосуточной работы. Размер меняется в любой момент: приложение переедет за один деплой, пересоздавать его не нужно. Все размеры - в разделе [Размеры приложения](/docs/apps/sizes/)
   - «Сон и масштаб» - сон без запросов и число экземпляров, воркер не засыпает
   - «Сколько это будет стоить» - стоимость приложения до создания
3. **Нажми «Создать приложение».** Платформа создаёт приложение и сразу заказывает первую версию: отдельной кнопки деплоя нет. Лог сборки идёт на экране строка за строкой. Сборка занимает до 16 минут, дальше платформа её останавливает. Упавшая сборка работающую версию не трогает, а в логе видно, на какой строке она сломалась: [Лог сборки](/docs/observability/build-log/).
4. **Открой адрес.** Когда сборка закончится, приложение отвечает по HTTPS на адресе платформы. Свой домен привязывается отдельно: [Свой домен](/docs/domains/custom-domain/).

Дальше каждый push в выбранную ветку заводит новую версию сам: [Автодеплой по push](/docs/deploy/auto-deploy/).

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

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

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

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

На macOS и Linux:

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

На Windows:

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

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

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

```bash
nodbox login
```

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

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

```bash
nodbox mcp add
```

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

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

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

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

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

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

Полный список фраз - в разделе [Фразы для агента](/docs/automation/prompts/).

## Права агента

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

## Что дальше

- [Переменные и секреты](/docs/apps/env/) - настройки и ключи для приложения
- [Порт, протокол и проверка готовности](/docs/apps/runtime/) - порт, который слушает приложение, и путь проверки готовности
- [Управляемый PostgreSQL](/docs/databases/postgres/) - база рядом с приложением
- [Логи приложения](/docs/observability/logs/) - что приложение пишет, пока работает
- [Тарификация](/docs/project/billing/) - за что списываются деньги

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

- Сборка не прошла: смотри [Лог сборки](/docs/observability/build-log/).
- Приложение собралось, но адрес не открывается: загляни в [Порт, протокол и проверка готовности](/docs/apps/runtime/) и [Типичные сбои и что делать](/docs/help/troubleshooting/).
- Агент не видит nodbox: проверь права токена и подключение в разделе [Подключение MCP-сервера](/docs/automation/mcp-setup/).