# NocoDB
Transforma banco de dados relacional em uma interface de planilha inteligente e moderna
# Instalação e Configuração NocoDB
Procedimentos de instalação e configuração NocoDB
# Instalação NocoDB
Link: [https://hub.docker.com/r/nocodb/nocodb](https://hub.docker.com/r/nocodb/nocodb)
[https://github.com/nocodb/nocodb](https://github.com/nocodb/nocodb) git clone [https://github.com/nocodb/nocodb.git](https://github.com/nocodb/nocodb.git)
NocoDB is the fastest and easiest way to build databases online.
[**Website**](http://www.nocodb.com/) • [**Discord**](https://discord.gg/c7GEYrvFtT) • [**Community**](https://community.nocodb.com/) • [**Twitter**](https://twitter.com/nocodb) • [**Reddit**](https://www.reddit.com/r/NocoDB/) • [**Documentation**](https://docs.nocodb.com/)
[**See other languages »**](https://github.com/nocodb/nocodb/blob/develop/markdown/readme/languages/README.md)
[](https://capacita.multiautomacoes.com.br/uploads/images/gallery/2026-11/image.png)
[](https://camo.githubusercontent.com/d4b0c1dc6ab6221beeefa45693dea409f6c3156283334b42c50053ea3f7e82d1/68747470733a2f2f7374617469632e73636172662e73682f612e706e673f782d707869643d63313261373763632d383535652d343630322d386130662d363134623264306461353661)
# Join Our Community
[](https://discord.gg/c7GEYrvFtT)
### Installation
#### Docker with SQLite
```bash
docker run -d \
--name noco \
-v "$(pwd)"/nocodb:/usr/app/data/ \
-p 8080:8080 \
nocodb/nocodb:latest
```
#### Docker with PG
```bash
docker run -d \
--name noco \
-v "$(pwd)"/nocodb:/usr/app/data/ \
-p 8080:8080 \
-e NC_DB="pg://host.docker.internal:5432?u=root&p=password&d=d1" \
-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \
nocodb/nocodb:latest
```
#### Nix
```bash
nix run github:nocodb/nocodb
```
#### NixOS
To use NocoDB as a NixOS module, a flake.nix would be as follows:
```bash
{
description = "Bane's NixOS configuration";
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
nocodb.url = "github:nocodb/nocodb";
};
outputs = inputs@{ nixpkgs, nocodb, ... }: {
nixosConfigurations = {
hostname = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
./configuration.nix
nocodb.nixosModules.nocodb
{
services.nocodb.enable = true;
}
];
};
};
};
}
```
#### Auto-upstall
Auto-upstall is a single command that sets up NocoDB on a server for production usage. Behind the scenes it auto-generates docker-compose for you.
```bash
bash <(curl -sSL http://install.nocodb.com/noco.sh) <(mktemp)
```
Auto-upstall does the following: 🕊
- 🐳 Automatically installs all pre-requisites like docker, docker-compose
- 🚀 Automatically installs NocoDB with PostgreSQL, Redis, Minio, Traefik gateway using Docker Compose. 🐘 🗄️ 🌐
- 🔄 Automatically upgrades NocoDB to the latest version when you run the command again.
- 🔒 Automatically setups SSL and also renews it. Needs a domain or subdomain as input while installation.
> install.nocodb.com/noco.sh script can be found [here in our github](https://raw.githubusercontent.com/nocodb/nocodb/develop/docker-compose/1_Auto_Upstall/noco.sh)
#### Other Methods
> Binaries are only for quick testing locally.
> When running locally access nocodb by visiting: [http://localhost:8080/dashboard](http://localhost:8080/dashboard)
For more installation methods, please refer to [our docs](https://docs.nocodb.com/category/installation)
### Screenshots
### Features
##### Rich Spreadsheet Interface
- ⚡ Basic Operations: Create, Read, Update and Delete Tables, Columns, and Rows
- ⚡ Fields Operations: Sort, Filter, Group, Hide / Unhide Columns
- ⚡ Multiple Views Types: Grid (By default), Gallery, Form, Kanban and Calendar View
- ⚡ View Permissions Types: Collaborative Views, & Locked Views
- ⚡ Share Bases / Views: either Public or Private (with Password Protected)
- ⚡ Variant Cell Types: ID, Links, Lookup, Rollup, SingleLineText, Attachment, Currency, Formula, User, etc
- ⚡ Access Control with Roles: Fine-grained Access Control at different levels
- ⚡ and more ...
##### App Store for Workflow Automations
We provide different integrations in three main categories. See [App Store](https://docs.nocodb.com/account-settings/oss-specific-details/#app-store) for details.
- ⚡ Chat: Slack, Discord, Mattermost, and etc
- ⚡ Email: AWS SES, SMTP, MailerSend, and etc
- ⚡ Storage: AWS S3, Google Cloud Storage, Minio, and etc
##### Programmatic Access
We provide the following ways to let users programmatically invoke actions. You can use a token (either JWT or Social Auth) to sign your requests for authorization to NocoDB.
- ⚡ REST APIs
- ⚡ NocoDB SDK
### Contributing
Please refer to [Contribution Guide](https://github.com/nocodb/nocodb/blob/master/.github/CONTRIBUTING.md).
### Why are we building this?
Most internet businesses equip themselves with either spreadsheet or a database to solve their business needs. Spreadsheets are used by Billion+ humans collaboratively every single day. However, we are way off working at similar speeds on databases which are way more powerful tools when it comes to computing. Attempts to solve this with SaaS offerings have meant horrible access controls, vendor lock-in, data lock-in, abrupt price changes & most importantly a glass ceiling on what's possible in the future.
### Our Mission
ur mission is to provide the most powerful no-code interface for databases, accessible to every internet business across the world. By making this capability broadly available under a fair and sustainable model, we aim to democratise access to powerful computing tools and enable a billion-plus people to develop radical tinkering and building abilities on the internet.
### License
This project is licensed under [Sustainable Use License](https://github.com/nocodb/nocodb/blob/develop/LICENSE.md).
### Contributors
Thank you for your contributions! We appreciate all the contributions from the community.
# Instalação customizada NocoDB
Link: [https://nocodb.com/docs/self-hosting/installation/custom-infrastructure](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure)
### Custom Infrastructure
Use this page for NocoDB deployments that the single-server installation wizard does not cover. These include managed databases, custom SSL certificates, private CAs, your own reverse proxy, multi-replica setups and Kubernetes.
### [Before you begin](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#before-you-begin)
NocoDB works with all actively maintained PostgreSQL releases (12 and later). Use the version that your managed provider offers. We recommend a current major version.
### [When to use this page](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#when-to-use-this-page)
Use this page if one of these is true:
- You use a managed Postgres (RDS, Azure, Cloud SQL) with public CA SSL.
- You use a self-managed Postgres with a private or internal CA.
- You already have a TLS certificate and want to pin it through Traefik.
- You have nginx, Caddy or a load balancer in front, and want NocoDB on port 8080.
- You deploy to Kubernetes and want a reference compose file to translate.
### [Option A: Clone the repo and run the wizard interactively](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#option-a-clone-the-repo-and-run-the-wizard-interactively)
```
git clone https://github.com/nocodb/nocodb.git
cd nocodb/docker-compose
./setup.sh
```
`setup.sh` runs the same installation wizard as the [Single-server install](https://nocodb.com/docs/self-hosting/installation/single-server) one-liner. It writes its output into the current working directory. Use this option to edit the generated files before you start the stack.
### [Option B: Copy a pre-built example](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#option-b-copy-a-pre-built-example)
The [`docker-compose/examples/`](https://github.com/nocodb/nocodb/tree/develop/docker-compose/examples) directory contains a set of selected configurations.
To start quickly with an example:
git clone --depth 1 https://github.com/nocodb/nocodb.git
cp -r nocodb/docker-compose/examples/managed-postgres ./my-deployment
cd my-deployment
\# Edit docker-compose.yml, docker.env, and nocodb/db.json: replace placeholders
docker compose up -d
```
git clone --depth 1 https://github.com/nocodb/nocodb.git
cp -r nocodb/docker-compose/examples/managed-postgres ./my-deployment
cd my-deployment
# Edit docker-compose.yml, docker.env, and nocodb/db.json: replace placeholders
docker compose up -d
```
## [Configuring SSL for an external Postgres with a private CA](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#configuring-ssl-for-an-external-postgres-with-a-private-ca)
SSL for an external Postgres with a private CA is the most complex external database setup. NocoDB reads its database connection from `nocodb/db.json` (knex format). In this file, you can put a CA certificate inline:
The CA must be one string, with newlines escaped as `\n`. The `postgres-private-ca` example shows the full layout, with a Traefik proxy.
To change a multi-line PEM into the single-line JSON form, run:
## [Multi-replica / scaling](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#multi-replica--scaling)
NocoDB scales horizontally when you configure Redis. Redis is necessary for distributed coordination:
For more than a few replicas, run NocoDB in Kubernetes. Translate one of the examples into a Deployment + Service + Ingress. Point the same env vars at managed Postgres and Redis.
## [Bringing your own reverse proxy](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure#bringing-your-own-reverse-proxy)
The `managed-postgres` and `external-postgres-and-redis` examples expose NocoDB on host port 8080, without Traefik.
1. Put your own nginx, Caddy or load balancer in front.
2. Forward HTTP traffic to port 8080.
3. Forward the `X-Forwarded-Proto` and `Host` headers. NocoDB needs them to make correct callback URLs.
# Quickstart NocoDB
Link: [https://nocodb.com/docs/self-hosting/installation/quickstart](https://nocodb.com/docs/self-hosting/installation/quickstart)
The Quickstart is the fastest way to try NocoDB locally. One command downloads the installer and makes a Compose stack (NocoDB, a worker, Postgres and Redis). Then it starts the stack on [http://localhost:8080](http://localhost:8080/). It works on Mac, Windows and Linux.
## [Before you begin](https://nocodb.com/docs/self-hosting/installation/quickstart#before-you-begin)
You need Docker Desktop (Mac/Windows) or Docker Engine (Linux). Install it from [docker.com](https://www.docker.com/products/docker-desktop/) before you run the command below.
## [1. Run](https://nocodb.com/docs/self-hosting/installation/quickstart#1-run)
This command writes a ready-to-run stack into `nocodb/` and starts it. The first run pulls the images, so it can take a few minutes.
## [2. Open NocoDB](https://nocodb.com/docs/self-hosting/installation/quickstart#2-open-nocodb)
1. Open [http://localhost:8080](http://localhost:8080/).
2. Sign up with an email and password. The first user becomes super admin.
## [What this runs](https://nocodb.com/docs/self-hosting/installation/quickstart#what-this-runs)
Container
Image
Purpose
`nocodb`
`nocodb/nocodb:latest`
The web app and API
`worker`
`nocodb/nocodb:latest`
Background jobs (imports, exports, automations)
`db`
`PostgreSQL`
Stores metadata and your data
`redis`
`Redis`
Caching and job queue
Docker keeps the data in **named volumes** (`postgres_data`, `redis_data`, `nocodb_data`). The data stays after restarts and after `docker compose down`. To list the volumes, run `docker volume ls`.
## [Common operations](https://nocodb.com/docs/self-hosting/installation/quickstart#common-operations)
The installer writes all files into `nocodb/`. Run these commands from that directory:
```
cd nocodb#
Tail logs
docker compose logs -f nocodb
# Stop everything (keeps your data)
docker compose down
# Start again
docker compose up -d
# Update to the latest version
docker compose pull && docker compose up -d
```
## [Prefer not to run a script?](https://nocodb.com/docs/self-hosting/installation/quickstart#prefer-not-to-run-a-script)
Get the same four-container stack from the [`quickstart-demo` example](https://github.com/nocodb/nocodb/tree/develop/docker-compose/examples/quickstart-demo) on GitHub. It is a plain Compose file that you can read before you run it.
1. Copy its `docker-compose.yml` into an empty directory.
2. Start it:
```
docker compose up -d
```
It is the same stack, without the installer. Run the operations above from that directory.
## [Next steps](https://nocodb.com/docs/self-hosting/installation/quickstart#next-steps)
- **Deploying to a server?** Refer to [Single-server install](https://nocodb.com/docs/self-hosting/installation/single-server). It uses the same single command, and adds automatic Traefik + Let's Encrypt SSL.
- **Need managed Postgres, custom SSL, or your own infrastructure?** For example configurations, refer to [Custom infrastructure](https://nocodb.com/docs/self-hosting/installation/custom-infrastructure).
- **Want enterprise features?** [Purchase a license](https://nocodb.com/docs/self-hosting/purchase-license), then [activate it](https://nocodb.com/docs/self-hosting/license-activation).
- **Something not working?** For startup, network, SSL and attachment problems, refer to [Troubleshooting](https://nocodb.com/docs/self-hosting/troubleshooting).