logologo
Get Started
Tutorials
Guide
Development
Plugins
API
Home
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Get Started
Tutorials
Guide
Development
Plugins
API
Home
logologo
How NocoBase Works
System Requirements
Installation and Version Comparison

Install NocoBase

Docker Installation
create-nocobase-app Installation
Git Source Installation
Environment Variables

Upgrade NocoBase

Upgrade Docker Installation
Upgrade create-nocobase-app Installation
Upgrade Git Source Installation

Deployment

Production Environment Deployment

Intranet Deployment

Docker
create-nocobase-app

Static Resource Proxy

nginx
caddy
cdn

Common Operations Commands

docker compose
pm2
How to Deploy Faster
Install and Upgrade Plugins
Translation Contribution
Previous PageDocker Installation
Next PageGit Source Installation

#create-nocobase-app Installation

Prerequisites
  • Node.js 20+, Yarn 1.22.x installed
  • One of the following databases configured and running: MySQL 8.0.17+, MariaDB 10.9+, or PostgreSQL 10+

#1. Create a NocoBase Project

Select the NocoBase version (Version Comparison) and database type, then execute the corresponding command.

Latest Version
Beta Version
Alpha Version
PostgreSQL
MySQL
MariaDB
yarn create nocobase-app my-nocobase-app -d postgres \
   -e DB_HOST=localhost \
   -e DB_PORT=5432 \
   -e DB_DATABASE=nocobase \
   -e DB_USER=nocobase \
   -e DB_PASSWORD=nocobase \
   -e TZ=UTC
Environment Variable Description
  • TZ is used to set the application's time zone, defaulting to the operating system's time zone.
  • APP_KEY is the application's secret key, used for generating user tokens, etc. (If APP_KEY is modified, old tokens will become invalid). It can be any random string. Please change it to your own secret key and ensure it is not exposed.
  • DB_* are database-related configurations. Please modify them according to your actual database connection information.

#2. Switch Directory

cd my-nocobase-app

#3. Install Dependencies

📢 This step may take several minutes depending on your network environment and system configuration.

yarn install
Production Environment Tip

When deploying to a production environment, you can install only the necessary dependencies to reduce the size:

yarn install --production

#4. Install NocoBase

yarn nocobase install --lang=en-US

The installation process will automatically create the database table structure and initialize data.

#5. Start NocoBase

Development Environment

yarn dev

Production Environment

yarn start

#6. Log in to NocoBase

Open http://localhost:13000 in your browser. The initial account and password are admin@nocobase.com and admin123.

Account Security Tip

After your first login, please change the default password immediately to ensure system security.