Deploy and Host NocoDB on Sealos

NocoDB turns databases into collaborative smart spreadsheets and no-code applications. This template deploys NocoDB with a Kubeblocks-managed PostgreSQL metadata database and persistent application storage on Sealos Cloud.

About Hosting NocoDB

NocoDB provides a spreadsheet-style interface for building tables, views, forms, automations, and lightweight internal tools on top of relational data. It is commonly used as an open-source Airtable alternative for teams that want database-backed collaboration without writing a custom admin interface.

This Sealos template runs the NocoDB web service from the pinned nocodb/nocodb:2026.05.2 image. Sealos provisions a PostgreSQL postgresql-16.4.0 cluster for NocoDB metadata, a persistent volume for /usr/app/data, an internal service, and an HTTPS ingress with a public URL.

Common Use Cases

• Internal data tools: Build spreadsheet-like interfaces for operations, support, and admin workflows.
• No-code apps: Create forms, views, and collaborative interfaces on top of structured data.
• Database frontends: Manage PostgreSQL, MySQL, MariaDB, SQLite, SQL Server, and other connected databases through a visual UI.
• Team collaboration: Share database-backed workspaces with role-based access.

Dependencies for NocoDB Hosting

The Sealos template includes all required runtime dependencies for a standalone NocoDB deployment.

Deployment Dependencies

• NocoDB Documentation - Official product documentation
• NocoDB GitHub Repository - Source code and release notes
• NocoDB Docker Image - Official container image

Implementation Details

Architecture Components:

• NocoDB: Web application and API service running on port 8080
• PostgreSQL: Kubeblocks-managed postgresql-16.4.0 cluster for NocoDB metadata
• Persistent storage: 1Gi volume mounted at /usr/app/data
• Ingress: Sealos-managed HTTPS public endpoint

Configuration:

• NC_DB is built from the Kubeblocks PostgreSQL connection secret.
• NC_PUBLIC_URL is set to the generated Sealos HTTPS URL.
• NC_ADMIN_EMAIL and NC_ADMIN_PASSWORD initialize the first admin account.

License Information:

NocoDB is available under the GNU Affero General Public License v3.0. Review the upstream repository for current licensing details.

Why Deploy NocoDB on Sealos?

Sealos is an AI-assisted Cloud Operating System built on Kubernetes that unifies the entire application lifecycle, from development in cloud IDEs to production deployment and management. It is ideal for running modern web applications and database-backed tools. By deploying NocoDB on Sealos, you get:

• One-Click Deployment: Deploy NocoDB, PostgreSQL, persistent storage, service, and ingress from one template.
• Managed Database: Use a Kubeblocks PostgreSQL cluster without manually operating database YAML.
• Persistent Storage Included: Keep NocoDB local data across restarts and rescheduling.
• Instant Public Access: Open NocoDB through a generated HTTPS URL after deployment.
• Easy Customization: Adjust resources and environment variables through Sealos resource cards or the AI dialog.
• Kubernetes Without the Complexity: Run on Kubernetes while managing the app through the Sealos dashboard.

Deployment Guide

1. Open the NocoDB template and click Deploy Now.
2. Configure the deployment parameters:
   • NC_ADMIN_EMAIL: initial admin email address.
   • NC_ADMIN_PASSWORD: initial admin password. The template generates a random value by default; save the final value before opening NocoDB.
3. Wait for deployment to complete, typically 2-4 minutes. After deployment, you will be redirected to the Canvas.
4. Open the generated NocoDB URL from the App card.
5. Sign in with the NC_ADMIN_EMAIL and NC_ADMIN_PASSWORD values configured during deployment.

Configuration

After deployment, you can configure NocoDB through:

• NocoDB UI: Create workspaces, bases, tables, views, forms, and integrations.
• AI Dialog: Describe changes you want Sealos to apply to resources.
• Resource Cards: Click the StatefulSet, PostgreSQL cluster, service, or ingress cards to modify settings.

Scaling

To adjust resources:

1. Open the Canvas for your deployment.
2. Click the NocoDB StatefulSet resource card.
3. Adjust CPU or memory resources as needed.
4. Apply the changes in the dialog.

The template uses a conservative single-replica deployment with persistent storage. Review NocoDB upstream guidance before changing replica count.

Troubleshooting

Cannot sign in

Confirm that you are using the exact NC_ADMIN_EMAIL and NC_ADMIN_PASSWORD configured during deployment. If you kept the generated password, copy it from the deployment parameters. The template initializes this account on first start.

Application is still starting

NocoDB may take a few minutes during the first cold start while PostgreSQL becomes ready and metadata tables are initialized. Wait for the NocoDB StatefulSet to show Ready in the Sealos Canvas.

Getting Help

• NocoDB Documentation
• NocoDB GitHub Issues
• Sealos Discord

Additional Resources

• NocoDB Website
• NocoDB API Documentation
• NocoDB Docker Hub

License

NocoDB is licensed under AGPL-3.0. See the upstream project for details.