Install from Git Source
- Git, Node.js 20+, and Yarn 1.22.x are installed
- A required database is configured and running: MySQL 8.0.17+, MariaDB 10.9+, or PostgreSQL 10+
1. Download NocoBase to your local machine
Choose a NocoBase version (Version Comparison) and run the corresponding command.
2. Change directory
3. Install dependencies
📢 This step may take more than ten minutes, depending on your network environment, system configuration, and other factors.
4. Set environment variables
The environment variables required by NocoBase are stored in the .env file in the root directory. Modify the environment variables according to your actual situation.
TZis used to set the application's time zone, which defaults to the operating system's time zone.APP_KEYis the application's secret key, used for generating user tokens, etc. (IfAPP_KEYis changed, 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. If you are not using the default database service from the example, please modify them according to your actual situation.
5. Install NocoBase
6. Start NocoBase
Development environment
Production environment (not recommended)
It is not recommended to deploy from source in a production environment. For production, please refer to Production Deployment.
7. Log in to NocoBase
Open http://localhost:13000 in your browser. The initial account and password are admin@nocobase.com and admin123.
After logging in for the first time, please change the default password promptly to ensure system security.