Skip to main content
Get up and running with NocoDB quickly by following this step-by-step guide. You’ll go from installation to creating your first base and table in just a few minutes.
1

Install NocoDB with Docker

The fastest way to get started is using Docker. Run this command to start NocoDB:
docker run -d \
  --name noco \
  -v "$(pwd)"/nocodb:/usr/app/data/ \
  -p 8080:8080 \
  nocodb/nocodb:latest
NocoDB will be available at http://localhost:8080/dashboard after the container starts.
For other installation methods, see the Installation guide.
2

Create your account

When you first access NocoDB, you’ll be prompted to create an admin account:
  1. Open http://localhost:8080/dashboard in your browser
  2. Enter your email address
  3. Create a secure password
  4. Click Sign up to create your account
The first account created automatically becomes the workspace owner with full administrative privileges.
3

Create your first base

After signing in, you’ll be taken to the workspace dashboard:
  1. Click Create Base or New Base
  2. Choose between:
    • Create blank base - Start with an empty base
    • Create base from external database - Connect to existing MySQL, PostgreSQL, or SQLite database
  3. Enter a name for your base (e.g., “Project Management”)
  4. Click Create
Bases are like databases in NocoDB. Each base can contain multiple tables and represents a complete application or project.
4

Create your first table

Once inside your base:
  1. Click Add new table or the + button
  2. Enter a table name (e.g., “Tasks”)
  3. NocoDB automatically creates an Id field as the primary key
  4. Add your first custom field:
    • Click + next to the Id column
    • Choose a field type (e.g., “SingleLineText”)
    • Name it “Title”
    • Click Save
  5. Add more fields as needed (Status, Due Date, Assignee, etc.)
NocoDB supports 40+ field types including text, numbers, dates, attachments, formulas, links to other tables, and more.
5

Add your first record

Start adding data to your table:
  1. Click the + button at the bottom of the table or press Enter
  2. Type in the “Title” field (e.g., “Create project documentation”)
  3. Press Tab to move to the next field
  4. Fill in other fields
  5. Press Enter to save and create another record
Use keyboard shortcuts for faster data entry:
  • Enter: Create new row
  • Tab: Move to next field
  • Shift + Tab: Move to previous field
  • Delete: Delete selected row (with confirmation)
6

Explore different views

NocoDB offers multiple ways to visualize your data. Try switching between views:
The default spreadsheet-like interface. Perfect for:
  • Bulk data entry
  • Sorting and filtering
  • Quick edits
  • Viewing all data at once
To create a new view:
  1. Click + Create New View in the sidebar
  2. Choose your view type
  3. Configure the view settings
  4. Click Create View

​
Next steps

Now that you have NocoDB up and running, explore these key features:

Add relationships

Link tables together to create powerful relational databases

Set up filters

Create complex filters to find exactly the data you need

Create formulas

Use Excel-like formulas to compute values automatically

Set up webhooks

Automate workflows with webhooks triggered by data changes

​
Common actions

  1. Click on your workspace name in the top left
  2. Select Workspace Settings
  3. Go to Members tab
  4. Click Invite Member
  5. Enter their email and assign a role
  6. Click Send Invite
Team members will receive an email invitation to join your workspace.
  1. Open the view you want to share
  2. Click the Share button in the top right
  3. Enable Share View
  4. Optionally set a password
  5. Copy the generated link
Anyone with the link can access the shared view (with the password if set).
  1. When creating a new base, select Create base from external database
  2. Choose your database type (PostgreSQL, MySQL, SQLite)
  3. Enter connection details:
    • Host
    • Port
    • Database name
    • Username
    • Password
  4. Click Test Connection
  5. Once successful, click Connect
NocoDB will read your existing schema and create a base with all your tables.
  1. Open the view you want to export
  2. Click the … menu in the top right
  3. Select Download
  4. Choose your format (CSV, Excel, JSON)
  5. Click Export
The file will be downloaded to your computer.

​
Need help?

Documentation

Explore the full documentation

Discord Community

Join our Discord community

GitHub Issues

Report bugs or request features