Back to all templates
NocoDB logo

NocoDB

Development256MB+ RAM

Open-source Airtable alternative - turn any database into a smart spreadsheet

nocodedatabaseairtable-alternativespreadsheet

Deploy NocoDB in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select NocoDB

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy NocoDB on a VPS with Server Compass

Use the NocoDB template in Server Compass to deploy a self-hosted Airtable-style database UI with Postgres on your VPS, then verify the NocoDB web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating an NocoDB app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for NocoDB

Use the template picker search to find NocoDB in the Server Compass template catalog.

Searching for NocoDB in the Server Compass template picker
4
Step 4

Select the NocoDB template

Choose the NocoDB template. Server Compass fills the NocoDB web service, Postgres database, database name, database user, database password, public URL, and JWT secret.

NocoDB template selected in Server Compass
5
Step 5

Review the NocoDB settings

Confirm the app name and compose services. In this run, the app was named nocodb-demo and used host port 3001.

Reviewing NocoDB project settings and compose services
6
Step 6

Deploy NocoDB

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing NocoDB environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the NocoDB image, starts the container, and verifies the stack.

Server Compass deploying the NocoDB template on the VPS
8
Step 8

Confirm NocoDB is running

After deployment finishes, return to the Apps tab and confirm the NocoDB app is marked Running with its application URL available.

NocoDB template running in the Server Compass Apps tab
9
Step 9

Open NocoDB in the browser

Open the application URL in a browser. The NocoDB web UI confirms the site is reachable.

The deployed NocoDB web UI loaded in a browser

After NocoDB Opens

  • Create the first NocoDB super admin account before production use.
  • Configure HTTPS, base permissions, data sources, API tokens, and workspace settings before production use.
  • Add a domain and HTTPS before exposing NocoDB to users.
  • Back up the NocoDB Postgres volume before relying on it for production bases.

Verified Result

The NocoDB web UI loaded successfully in a browser.

NocoDB deployment questions

What does the NocoDB template deploy?

It deploys NocoDB with web and Postgres services.

Which port did the tutorial use?

The tutorial used host port 3001, which maps to the NocoDB web service on container port 8080.

Why does the guide stop at the first-run web UI?

The tutorial verifies the clean NocoDB first-run web UI because bases, data sources, API tokens, and workspace settings depend on the production server.

Should this become a blog post?

No. The deployment guide should live on the NocoDB template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying NocoDB with Server Compass, complete these steps to finish setup

1

Create super admin account

2

Create your first base

Need help? Check out our documentation for detailed guides.

NocoDB FAQ

Common questions about self-hosting NocoDB

How do I deploy NocoDB with Server Compass?

Simply download Server Compass, connect to your VPS, and select NocoDB from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for NocoDB?

NocoDB requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing NocoDB data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard NocoDB backup and restore procedures.

How do I update NocoDB to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest NocoDB image will be pulled and deployed with zero downtime.

Is NocoDB free to self-host?

NocoDB is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host NocoDB?

Download Server Compass and deploy NocoDB to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass