After the introduction, you are probably itching to try it. This tutorial starts with provisioning a NocoDB instance and takes you all the way through creating your first Base, adding a table, setting field types, entering data, switching between views, and finally sharing your work or wiring it up over the API. You will not write a single line of SQL.
30-second overview
| Item | Details |
|---|---|
| What you build | Your first usable table, with several views |
| How long it takes | About 20 minutes |
| The first decision | Field types — getting them right saves a lot of pain |
| Most common mistake | Making everything a text field |
| What comes next | Links, formulas, views, permissions |
Step 1: Provision NocoDB from the RoamerHost dashboard
It all starts on the RoamerHost fully managed platform. You do not need a server, and you install nothing:
- Open your browser, go to the dashboard at https://roamerhost.com/app, and log in.
- Pick NocoDB from the product list and choose the plan that fits you.
- Click create. The system deploys an isolated container for you, with automatic SSL and a dedicated subdomain.
- When the deployment finishes, you get a
*.roamerhost.comaddress of your own. That is the entrance to your NocoDB.
For the resources and features each plan includes, see plans and pricing. Monthly subscription, credit card payments through NewebPay, cancel any time.
Step 2: Log in to NocoDB and get to know the interface
The first time you open your NocoDB address, the system walks you through creating an admin account (email and password). Once you are in, you land in a Workspace, which is where all of your Bases live.
The NocoDB hierarchy is easy to grasp:
- Base: a container for one project or app, such as "Customer management" or "Project tracking".
- Table: a data table inside a Base, such as "Customer list" or "Task list".
- View: a different way of presenting the same table.
Step 3: Create your first Base
A Base is like a folder that gathers related tables together. To create one:
- In the workspace, click "Create Base".
- Give it a name people will understand, such as
Project Management. - Once you confirm, NocoDB creates an empty Base with a sample table so you have somewhere to start.
Name a Base after its purpose rather than a date or a code. That way everyone on the team knows what it is at a glance.
Step 4: Add a Table and set field types
Next, create a table in the Base that you will actually use. Say you want a simple task list:
- Inside the Base, click "+" to add a table and name it
Task List. - Click the "+" next to the field headers to add fields, and choose a suitable type for each one.
A practical task list might use these field types:
| Field name | Suggested type | Purpose |
|---|---|---|
| Task name | Text | Describes the task |
| Status | Single Select | To do / In progress / Done |
| Owner | Text or Link | Who is responsible |
| Due date | Date | When it has to be finished |
| Attachments | Attachment | Related files or screenshots |
When you set up a single select field, create the options first ("To do", "In progress", "Done") and give each one a color. The Kanban view is much easier to read that way.
Step 5: Enter your first records
With the fields in place, you can start filling in data. The Grid view works like a spreadsheet:
- Click a cell and type text or numbers directly.
- Click the status field and pick from the dropdown options.
- Click a date field and a calendar pops up.
- Drag and drop files straight into an attachment field, or upload them.
You can also click the expand icon at the start of a row to edit it as a single-record card, which suits tables with many fields that need careful data entry.
Step 6: Switch views (Kanban and Form)
Once the data is in, the fun starts. The same Task List table can have several views:
Create a Kanban view
- In the view list on the left of the table, click "+" to add a view and choose Kanban.
- Set the field used for the columns to "Status".
- NocoDB splits the board into three columns for "To do / In progress / Done", and you can drag cards between them to change status.
Create a Form view
- Add another view, this time choosing Form.
- Adjust which fields the form shows, plus its title and description text.
- The form gets its own URL that you can share with the team or with people outside it. Every submission becomes a row in the table.
Switching views does not copy data. Drag a card on the Kanban board to change its status and the grid view updates too, because they share the same underlying records.
Step 7: Share data and use the automatic API
Once the table is built, you can share it or connect it to other systems:
- Share a view: every view can generate a share link, so people without an account can browse it read-only, or fill in a form you open up to them.
- Invite collaborators: add team members to the Base and assign permissions as needed to control who can view and who can edit.
- Automatic REST API: NocoDB generates a REST API for every table. The API docs page lists the endpoints for reading, creating and updating records, and with an API token you can call them from your own site or code.
- Webhooks: notify an external system or trigger an automation whenever a record is created or changed.
Next steps
Congratulations. You have gone from provisioning an instance to building your first table, one that your team can collaborate on, share, and call over an API. From here, try:
- Adding a Formula field to calculate days or amounts automatically.
- Using Lookup and Rollup to pull in or summarize information from linked tables.
- Gathering tables for different purposes into one Base to build a small system of your own.
Because your NocoDB runs in an isolated container on RoamerHost with automatic SSL and a dedicated subdomain, you can treat it as a real production tool for your team. Go build your first data app.
FAQ
Q: Do field types really matter?
They matter a lot, and the earlier you get them right, the better. Store a date as text and you cannot sort by it, build a calendar view, or calculate durations. Changing a type later can cause data conversion problems.
Q: How many tables should I start with?
Start with one. When you notice the same value repeating across many rows (a customer name, for example), that is the signal to split it into its own table and link to it. The formulas and links tutorial shows how.
Q: Can I import from Excel?
Yes. But it is better to set the field types up by hand before importing the data; letting the system infer them usually gets you a row of text fields.
Q: What is the difference between a view and a table?
A view is just a different presentation of the same data — filters, sorting and hidden fields only affect that view. Deleting a row in a view, though, really does delete it, so be careful. See the views tutorial for details.
Q: Is data saved automatically?
Yes, edits take effect immediately. That also means there is no "discard changes", so set permissions carefully on tables that matter.
Sources and further reading
For NocoDB field types and its permission model, the official documentation is authoritative:
Further reading
- NocoDB: The Open Source Airtable Alternative
- NocoDB Hosting FAQ: Data Volume, Exports and Multi-User Access
- NocoDB for Inventory Management: How Small Teams Actually Do It
- NocoDB FAQ: API Integration, Data Volume and Collaboration
Want someone to do it for you?
Once the data volume grows, or the system has to plug into what your company already runs, this stops being a question of picking a tool. Roamer Tech takes on custom enterprise systems and API integration: