Quickstart

The fastest way to try NocoDB locally. One command downloads the installer, generates a Compose stack (NocoDB, a worker, Postgres, and Redis), and starts it on http://localhost:8080. Works on Mac, Windows, and Linux.

1. Run

curl -fsSL https://install.nocodb.com/noco.sh | bash -s -- --quick

This writes a ready-to-run stack into nocodb/ and brings it up. The first run pulls the images, so it can take a few minutes.

2. Open NocoDB

Visit http://localhost:8080. Sign up with an email and password. The first user becomes super admin.

What this runs

Data is stored in Docker-managed named volumes (postgres_data, redis_data, nocodb_data), so it persists across restarts and docker compose down. List them with docker volume ls.

Common operations

The installer writes everything into nocodb/. Run these from there:

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?

Grab the same four-container stack from the quickstart-demo example on GitHub: a plain Compose file you can read before running. Copy its docker-compose.yml into an empty directory, then start it:

docker compose up -d

It's the identical stack, just without the installer. Run the operations above from that directory.

Next steps

• Deploying to a server? See Single-server install. Same single command, plus automatic Traefik + Let's Encrypt SSL.
• Need managed Postgres, custom SSL, or your own infrastructure? See Custom infrastructure for example configurations.
• Want enterprise features? Purchase a license, then activate it.
• Something not working? See Troubleshooting for startup, networking, SSL, and attachment issues.