---
title: Установить приложение NocoBase
description: Установите NocoBase CLI и быстро создайте новое приложение NocoBase с помощью `nb init --ui`, чтобы AI Agent мог сразу приступить к работе.
---

# Установить приложение NocoBase

## Предварительные требования

- Node.js >= 22
- Yarn 1.x
- Если Вы планируете установку через Docker, сначала убедитесь, что Docker уже запущен

## Шаг 1. Установить CLI

Сначала установите NocoBase CLI глобально:

```bash
npm install -g @nocobase/cli
nb --version
```

Если Вы часто работаете сразу в нескольких терминалах или хотите действовать параллельно с AI Agents, мы также рекомендуем один раз выполнить `nb session setup`. Тогда каждая сессия будет хранить собственный `current env`, и они будут меньше мешать друг другу.

## Шаг 2. Инициализировать приложение

Рекомендуем установить приложение через UI-мастер:

```bash
nb init --ui
```

1. `Getting started` - задать идентификатор `--env` и выбрать `Install a new app`

![2026-06-11-20-14-32](https://static-docs.nocobase.com/2026-06-11-20-14-32.png)

2. `App environment` - задать основные параметры приложения, место хранения и runtime-порт

![2026-06-14-10-03-06](https://static-docs.nocobase.com/2026-06-14-10-03-06.png)

3. `App source and version` - выбрать способ получения приложения, а также source и version

![2026-06-14-09-51-33](https://static-docs.nocobase.com/2026-06-14-09-51-33.png)

4. `Configure the database` - выбрать встроенную базу данных или пользовательскую базу данных

![2026-06-14-09-52-05](https://static-docs.nocobase.com/2026-06-14-09-52-05.png)

5. `Create an admin account` - настроить первую учётную запись администратора

![2026-06-14-09-52-56](https://static-docs.nocobase.com/2026-06-14-09-52-56.png)

6. `Connection & authentication` - указать URL доступа к приложению и выбрать способ аутентификации

![2026-06-14-10-00-35](https://static-docs.nocobase.com/2026-06-14-10-00-35.png)

Если Вам привычнее работать в терминале, можно также выполнить:

```bash
nb init
```

Если инициализация нужна в скриптах или CI, используйте неинтерактивный режим:

```bash
nb init --yes --env app1
```

:::tip Установка на удалённом сервере

Если Вы запускаете `nb init --ui` на сервере, мы рекомендуем сначала изменить стандартный host на IP-адрес этого сервера. Тогда Вы сможете открыть мастер из локального браузера.

```bash
nb config set default-ui-host <server-ip>
nb config set default-api-host <server-ip>
```

:::

## Шаг 3. Проверить, что приложение готово

После установки обычно стоит сначала проверить три вещи:

- Env успешно сохранён
- Приложение запустилось без ошибок
- Вы можете войти под учётной записью администратора

Чаще всего используются такие команды:

```bash
nb env list
nb env info
nb app logs
```

Для локальной установки с настройками по умолчанию обычно достаточно открыть `http://localhost:13000` в браузере. После входа откройте новую сессию AI Agent или перезапустите текущую — и ИИ сможет начать работу с этим приложением NocoBase.

Конфигурация CLI по умолчанию хранится в `~/.nocobase/`, поэтому AI Agents обычно могут обращаться к ней из любого рабочего каталога.

Если это приложение позже будет доступно реальным пользователям, мы не рекомендуем надолго оставлять прямой доступ через `IP + port`. Обычно следующим шагом становится настройка reverse proxy и включение HTTPS.

## Дальше

- Если у Вас уже есть запущенное приложение NocoBase, смотрите [Руководство по подключению AI Agent](./quick-start.mdx)
- Если нужно управлять запуском, остановкой, логами и обновлением приложения, смотрите [Управление приложениями](../nocobase-cli/operations/manage-app.md)
- Если хотите продолжить с production-развертыванием, смотрите [Установка приложений через CLI](../nocobase-cli/installation/cli.md) и [Обзор production-развертывания](../nocobase-cli/production/index.md)
- Если хотите, чтобы ИИ начал собирать приложения, смотрите [AI Builder](../ai-builder/index.md)

## Связанные ссылки

- [Сравнение способов установки и версий](../get-started/quickstart.md) — Сначала сравните способы установки и каналы версий, а потом выберите, как именно устанавливать
- [Руководство по подключению AI Agent](./quick-start.mdx) — Подключите существующее приложение NocoBase и дайте AI Agent начать работу
- [Справка по команде `nb init`](../api/cli/init.md) — Инициализировать новое приложение, взять под управление существующее локальное приложение или подключить удалённое приложение
- [Справка по команде `nb env info`](../api/cli/env/info.md) — Посмотреть сведения о подключении и runtime-конфигурацию текущего env
- [NocoBase CLI](../api/cli/index.md) — Полная справка по всем командам `nb`
- [Управление приложениями](../nocobase-cli/operations/manage-app.md) — Запуск, остановка, перезапуск, просмотр логов и обновление приложений
- [Множественное управление средой](../nocobase-cli/operations/multi-environment.md) — Типовые операции, когда Вы одновременно поддерживаете несколько env
