• Português

      • Instalar o aplicativo NocoBase

      Pré-requisitos

      • Node.js >= 22
      • Yarn 1.x
      • Se pretende instalar com Docker, confira antes se o Docker já está em execução

      Passo 1: Instalar o CLI

      Primeiro, instale o NocoBase CLI globalmente:

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

      Se você costuma trabalhar com vários terminais ao mesmo tempo, ou quer operar em paralelo com AI Agents, também recomendamos executar nb session setup uma vez. Assim, cada sessão mantém o seu próprio current env, e fica menos provável que uma interfira na outra.

      Passo 2: Inicializar o aplicativo

      Recomendamos instalar pelo assistente de UI:

      nb init --ui
      1. Getting started - definir o identificador --env e escolher Install a new app

      2026-06-11-20-14-32

      1. App environment - definir as informações básicas do aplicativo, o local de armazenamento e a porta de execução

      2026-06-14-10-03-06

      1. App source and version - escolher como obter o aplicativo e qual source e version usar

      2026-06-14-09-51-33

      1. Configure the database - escolher o banco de dados embutido ou um banco de dados personalizado

      2026-06-14-09-52-05

      1. Create an admin account - configurar a primeira conta de administrador

      2026-06-14-09-52-56

      1. Connection & authentication - informar a URL de acesso do aplicativo e escolher um método de autenticação

      2026-06-14-10-00-35

      Se preferir trabalhar pela linha de comando, você também pode executar:

      nb init

      Se precisar inicializar em scripts ou em CI, use o modo não interativo:

      nb init --yes --env app1
      Instalação em um servidor remoto

      Se você executar nb init --ui em um servidor, recomendamos alterar antes o host padrão para o IP atual desse servidor. Assim, você poderá abrir o assistente no navegador local.

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

      Passo 3: Confirmar que o aplicativo está pronto

      Depois da instalação, normalmente vale a pena confirmar primeiro estas três coisas:

      • O env foi salvo com sucesso
      • O aplicativo iniciou normalmente
      • Você consegue entrar com a conta de administrador

      Os comandos mais usados são:

      nb env list
nb env info
nb app logs

      Em uma instalação local padrão, normalmente você pode abrir http://localhost:13000 diretamente no navegador. Depois de fazer login, inicie uma nova sessão do AI Agent ou reinicie a atual, e a IA poderá começar a trabalhar com este aplicativo NocoBase.

      As configurações do CLI ficam salvas em ~/.nocobase/ por padrão, então os AI Agents geralmente conseguem acessá-las a partir de qualquer diretório de trabalho.

      Se esse aplicativo for exposto a usuários reais no futuro, não recomendamos manter o uso direto de IP + port no longo prazo. O próximo passo costuma ser colocar a aplicação atrás de um proxy reverso e habilitar HTTPS.

      Próximos passos