• Español

      • Instalar la aplicación NocoBase

      Si todavía no tiene una aplicación NocoBase, la forma más rápida es instalar primero @nocobase/cli y luego ejecutar una vez nb init --ui. En la mayoría de los casos, la configuración por defecto del asistente es suficiente.

      Requisitos previos

      • Node.js >= 22
      • Yarn 1.x
      • Si piensa instalar con Docker, asegúrese primero de que Docker ya esté en ejecución

      Paso 1: Instalar CLI

      Primero instale NocoBase CLI de forma global:

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

      Si suele trabajar con varios terminales al mismo tiempo o quiere operar en paralelo con AI Agents, también le recomendamos ejecutar nb session setup una vez. Así, cada sesión mantendrá su propio current env y será menos probable que se interfieran entre sí.

      Paso 2: Inicializar la aplicación

      La opción recomendada es abrir directamente el asistente visual:

      nb init --ui

      2026-06-11-20-14-32

      Según la ruta de setup que siga, los pasos pueden variar un poco. Si sigue la ruta predeterminada Install a new app, normalmente verá estos seis pasos:

      1. Getting started - definir el identificador --env y elegir Install a new app
      2. App environment - configurar los datos básicos de la app, la ubicación de almacenamiento y el puerto de ejecución
      3. App source and version - elegir cómo obtener la app y qué origen y versión usar
      4. Configure the database - elegir la base de datos integrada o una base de datos personalizada
      5. Create an admin account - configurar la primera cuenta de administrador
      6. Connection & authentication - introducir la URL de acceso de la app y elegir un método de autenticación

      Si prefiere trabajar desde la terminal, también puede ejecutar:

      nb init

      Si necesita inicializar en scripts o en CI, utilice el modo no interactivo:

      nb init --yes --env app1
      Instalación en un servidor remoto

      Si ejecuta nb init --ui en un servidor, le recomendamos cambiar primero el host por defecto a la IP actual del servidor. Así podrá abrir el asistente desde su navegador local.

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

      Paso 3: Confirmar que la aplicación está lista

      Después de la instalación, normalmente conviene confirmar primero estas tres cosas:

      • Que el env se haya guardado correctamente
      • Que la aplicación se haya iniciado con normalidad
      • Que pueda iniciar sesión con la cuenta de administrador

      Los comandos más comunes son:

      nb env list
nb env info
nb app logs

      Si se trata de una instalación local con la configuración por defecto, normalmente podrá abrir http://localhost:13000 directamente en el navegador. Después de iniciar sesión, abra una nueva sesión del AI Agent o reinicie la actual, y la IA podrá empezar a trabajar con esta aplicación NocoBase.

      La configuración de la CLI se guarda por defecto en ~/.nocobase/, por lo que los AI Agents normalmente pueden acceder a ella desde cualquier directorio de trabajo.

      Si esta aplicación va a exponerse a usuarios reales más adelante, no recomendamos mantenerla a largo plazo usando directamente IP + port. El siguiente paso habitual es colocarla detrás de un proxy inverso y habilitar HTTPS.

      Enlaces relacionados