Chapter 1: Getting Started — Build a Working System in 5 Minutes
1.1 What Is NocoBase
1.2 Installing NocoBase
Prerequisites
Step 1: Download the Configuration File
Step 2: Start It Up
Step 3: Log In
1.3 Getting to Know the Interface
UI Editor Mode vs Usage Mode
Basic Interface Layout
1.4 What We're Going to Build
Summary
About NocoBase
👇 Get NocoBase In this series, we'll build a minimal IT HelpDesk system from scratch using NocoBase. The entire system needs only 2 data tables and zero lines of code — yet it will support ticket submission, category management, change tracking, access control, and even a dashboard. This chapter walks you through deploying NocoBase with Docker, completing your first login, and understanding the difference between UI Editor mode and Usage mode. Have you ever been in one of these situations? NocoBase was built to solve this problem. It's an open-source, highly extensible AI-powered no-code development platform. You can build your own business systems through configuration and drag-and-drop — no coding required. Compared to other no-code tools, NocoBase has a few core principles: NocoBase supports multiple installation methods. We'll go with the simplest: Docker. You need Docker and Docker Compose installed on your machine, with the Docker service running. Windows, Mac, and Linux are all supported. Open your terminal (PowerShell on Windows, Terminal on Mac) and run: Other databases? Replace postgres in the URL with mysql or mariadb.
You can also choose different versions: latest (stable), beta (testing), or alpha (development). See the official installation docs for details. When you see this line in the output, you're good to go: Open your browser and go to http://localhost:13000. Log in with the default credentials: Remember to change the default password after your first login. After logging in, you'll see a clean initial interface. Don't worry about it being empty — let's first understand two key concepts. NocoBase has two interface modes: To switch: click the "UI Editor" button in the top-right corner (a highlighter pen icon). When you enable UI Editor mode, you'll notice orange highlight borders appearing around many elements on the page — this means they're configurable. Each configurable element shows a small icon in its top-right corner; click it to access its settings. Here's what it looks like on a demo system: As shown above: menus, table action bars, and the bottom of the page all show orange indicators. Click them to create or configure elements. Remember this pattern: In NocoBase, whenever you want to modify something on the page, enter UI Editor mode, find the small icon in its top-right corner, and click it. The NocoBase interface is composed of three areas: It's still empty for now — but starting from the next chapter, we'll fill it up. Over the course of this tutorial, we'll build an IT HelpDesk system step by step. It will support: The entire system needs just 2 data tables: That's right, just 2 tables. Common capabilities like users, permissions, file management, departments, email, and audit logs are all provided by built-in NocoBase plugins — no need to reinvent the wheel. We only need to focus on our business data. Next chapter: We'll get hands-on — enter the Data Source Manager and create our first data table. This is the skeleton of the entire system and NocoBase's most fundamental capability. See you in Chapter 2! NocoBase is the most extensible AI-powered no-code platform.Total control. Infinite extensibility. AI collaboration.Enable your team to adapt quickly and cut costs dramatically.No years of development. No millions wasted.
Deploy NocoBase in minutes — and take control of everything. Discover NocoBase in 3 Minutes! Templates let you quickly answer FAQs or store snippets for re-use. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse
# Create a project directory and enter it
mkdir my-project && cd my-project # Download -weight: 500;">docker-compose.yml (defaults to PostgreSQL)
-weight: 500;">curl -fsSL https://static-docs.nocobase.com/-weight: 500;">docker-compose/en/latest-postgres.yml -o -weight: 500;">docker-compose.yml
# Create a project directory and enter it
mkdir my-project && cd my-project # Download -weight: 500;">docker-compose.yml (defaults to PostgreSQL)
-weight: 500;">curl -fsSL https://static-docs.nocobase.com/-weight: 500;">docker-compose/en/latest-postgres.yml -o -weight: 500;">docker-compose.yml
# Create a project directory and enter it
mkdir my-project && cd my-project # Download -weight: 500;">docker-compose.yml (defaults to PostgreSQL)
-weight: 500;">curl -fsSL https://static-docs.nocobase.com/-weight: 500;">docker-compose/en/latest-postgres.yml -o -weight: 500;">docker-compose.yml
# Pull images
-weight: 500;">docker compose pull # Start in background (first run will auto--weight: 500;">install)
-weight: 500;">docker compose up -d # Watch logs to confirm successful startup
-weight: 500;">docker compose logs -f app
# Pull images
-weight: 500;">docker compose pull # Start in background (first run will auto--weight: 500;">install)
-weight: 500;">docker compose up -d # Watch logs to confirm successful startup
-weight: 500;">docker compose logs -f app
# Pull images
-weight: 500;">docker compose pull # Start in background (first run will auto--weight: 500;">install)
-weight: 500;">docker compose up -d # Watch logs to confirm successful startup
-weight: 500;">docker compose logs -f app
🚀 NocoBase server running at: http://localhost:13000/
🚀 NocoBase server running at: http://localhost:13000/
🚀 NocoBase server running at: http://localhost:13000/
┌──────────────────────────────────────────┐
│ Top Navigation Bar │
├──────────┬───────────────────────────────┤
│ │ │
│ Left │ Content Area │
│ Sidebar │ (place blocks here) │
│ (groups) │ │
│ │ │
└──────────┴───────────────────────────────┘
┌──────────────────────────────────────────┐
│ Top Navigation Bar │
├──────────┬───────────────────────────────┤
│ │ │
│ Left │ Content Area │
│ Sidebar │ (place blocks here) │
│ (groups) │ │
│ │ │
└──────────┴───────────────────────────────┘
┌──────────────────────────────────────────┐
│ Top Navigation Bar │
├──────────┬───────────────────────────────┤
│ │ │
│ Left │ Content Area │
│ Sidebar │ (place blocks here) │
│ (groups) │ │
│ │ │
└──────────┴───────────────────────────────┘ - Your team needs an internal system, but off-the-shelf software never quite fits
- Hiring developers for a custom build is too expensive and too slow, and requirements keep changing
- You're using spreadsheets as a workaround, but the data keeps getting messier - Data model driven: Define your data structure first, then use blocks to display data, then actions to process it — UI and data are fully decoupled
- WYSIWYG: Pages are your canvas. Click anywhere to edit, as intuitive as building a Notion page
- Everything is a plugin: All features are plugins, similar to WordPress — -weight: 500;">install what you need
- AI built into your workflow: Built-in AI employees that can perform analysis, translation, data entry, and more
- Open source + self-hosted: Core code is fully open source, all data stays on your own server - Email: [email protected]
- Password: admin123 - Top Navigation Bar: Houses top-level menus for switching between modules
- Left Sidebar (groups): If using group menus, this shows second-level navigation to organize page hierarchy
- Content Area: The main body of the page, where you place various Blocks to display and interact with data - ✅ Ticket submission: Users fill in title, description, category, and priority
- ✅ Ticket list: Filter by -weight: 500;">status or category at a glance
- ✅ Access control: Regular users see only their own tickets; admins see everything
- ✅ Dashboard: Real-time statistics on ticket distribution and trends
- ✅ Audit log (built-in) - Learned what NocoBase is — an open-source no-code platform
- Installed and started NocoBase with Docker in one step
- Understood the two interface modes (UI Editor / Usage) and the basic layout
- Previewed the HelpDesk system we're going to build - Docker Installation Guide — Full installation options and environment variables
- System Requirements — Hardware and software requirements
- How NocoBase Works — Core concepts: data sources, blocks, actions
