< h1 align = "center" style = "border-bottom: none" >
< b >
< a href = "https://www.nocodb.com" > NocoDB < / a > < br >
< / b >
✨ The Open Source Airtable Alternative ✨ < br >
< / h1 >
< p align = "center" >
Turns any MySQL, PostgreSQL, SQL Server, SQLite & MariaDB into a smart-spreadsheet.
< / p >
< div align = "center" >
[](https://travis-ci.com/github/NocoDB/NocoDB)
[](http://nodejs.org/download/)
[](https://twitter.com/NocoDB)
< / div >
< p align = "center" >
< a href = "http://www.nocodb.com" > < b > Website< / b > < / a > •
< a href = "https://discord.gg/5RgZmkW" > < b > Discord< / b > < / a > •
< a href = "https://twitter.com/nocodb" > < b > Twitter< / b > < / a >
< / p >
< p align = "center" >
< img src = "/static/open-source-airtable-alternative/OpenSourceAirtableAlternative.png" width = "100%" >
< br / > < br / >
< / p >
# Quick try
### 1-Click Deploy
< a href = "https://heroku.com/deploy?template=https://github.com/npgia/nocodb-seed-heroku" >
< img
src="https://www.herokucdn.com/deploy/button.svg"
width="300px"
alt="Deploy NocoDB to Heroku with 1-Click"
/>
< / a >
< br >
### Using Docker
```bash
docker run -p 8080:8080 nocodb/nocodb
```
### Using Npm
```
npx create-nocodb-app
```
### Using Git
```
git clone https://github.com/nocodb/nocodb-seed
cd nocodb-seed
npm install
npm run dev
```
# Join Community
< a href = "https://discord.gg/5RgZmkW" >
< img
src="https://invidget.switchblade.xyz/5RgZmkW"
alt="Join NocoDB : Free & Open Source Airtable Alternative"
>
< / a >
< br >
# Features
### Rich Spreadsheet Interface
- ⚡ Search, sort, filter, hide columns with uber ease
- ⚡ Create Views : Grid, Gallery, Kanban, Gantt, Form
- ⚡ Share Views : public & password protected
- ⚡ Personal & locked Views
- ⚡ Upload images to cells (Works with S3, Minio, GCP, Azure, DigitalOcean, Linode, OVH, BackBlaze)!!
- ⚡ Roles : Owner, Creator, Editor, Commenter, Viewer, Commenter, Custom Roles.
- ⚡ Access Control : Fine-grained access control even at database, table & column level.
### App Store for workflow automations :
- ⚡ Chat : Microsoft Teams, Slack, Discord, Mattermost
- ⚡ Email : SMTP, SES, Mailchimp
- ⚡ SMS : Twilio
- ⚡ Whatsapp
- ⚡ Any 3rd Party APIs
### Programmatic API access via :
- ⚡ REST APIs (Swagger)
- ⚡ GraphQL APIs.
- ⚡ Includes JWT Authentication & Social Auth
- ⚡ API tokens to integrate with Zapier, Integromat.
# Production Setup
NocoDB requires a database to store metadata of spreadsheets views and external databases.
And environment `NC_DB` decides
## Docker
#### Example MySQL
```
docker run -p 8080:8080 -e NC_DB="mysql://host:port?u=user& p=password& d=database" nocodb/nocodb
```
#### Example Postgres
```
docker run -p 8080:8080 -e NC_DB="pg://host:port?u=user& p=password& d=database" nocodb/nocodb
```
#### Example SQL Server
```
docker run -p 8080:8080 -e NC_DB="mssql://host:port?u=user& p=password& d=database" nocodb/nocodb
```
## Environment variables
| Variable | Mandatory | Comments | If absent |
|-------------------------|-----------|----------------------------------------------------------------------------------|--------------------------------------------|
| NC_DB | Yes | See our database URLs | A local SQLite will be created in root folder |
| DATABASE_URL | No | JDBC URL Format. Can be used instead of NC_DB. Used in 1-Click Heroku deployment| |
| NC_PUBLIC_URL | Yes | Used for sending Email invitations | Best guess from http request params |
| NC_AUTH_JWT_SECRET | Yes | JWT secret used for auth and storing other secrets | A Random secret will be generated |
| NC_SENTRY_DSN | No | For Sentry monitoring | |
| NC_CONNECT_TO_EXTERNAL_DB_DISABLED | No | Disable Project creation with external database | |
| NC_DISABLE_TELE | No | Disable telemetry | |
# Our Mission : ❤
Our mission is to provide the most powerful no-code tool as open source to every single internet business in the world
which would not only democratise database-and-api access but also bring forth a revolution where a billion+ people will have tinkering-and-building abilities on internet.
# Contributors : 🌻🌻🌻🐝🐝
[//]: contributor-faces
< a href = "https://github.com/o1lab" > < img src = "https://avatars.githubusercontent.com/u/5435402?v=4" title = "Naveen MR" width = "50" height = "50" > < / a >
< a href = "https://github.com/pranavxc" > < img src = "https://avatars.githubusercontent.com/u/61551451?v=4" title = "Pranav C Balan" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/bvkatwijk" > < img src = "https://avatars.githubusercontent.com/u/18490578?s=60&v=4" title = "bvkatwijk" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/markuman" > < img src = "https://avatars.githubusercontent.com/u/3920157?s=60&v=4" title = "markuman" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/DanielRuf" > < img src = "https://avatars.githubusercontent.com/u/827205?s=60&v=4" title = "DanielRuf" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/bertyhell" > < img src = "https://avatars.githubusercontent.com/u/1710840?s=60&v=4" title = "bertyhell" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/chocholand" > < img src = "https://avatars.githubusercontent.com/u/6572227?s=60&v=4" title = "chocholand" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/0xflotus" > < img src = "https://avatars.githubusercontent.com/u/26602940?s=60&v=4" title = "0xflotus" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/sguionni" > < img src = "https://avatars.githubusercontent.com/u/3633017?s=60&v=4" title = "sguionni" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/extremeshok" > < img src = "https://avatars.githubusercontent.com/u/5957328?s=60&v=4" title = "extremeshok" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/v2io" > < img src = "https://avatars.githubusercontent.com/u/48987429?s=60&v=4" title = "v2io" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/soaserele" > < img src = "https://avatars.githubusercontent.com/u/1093368?s=60&v=4" title = "soaserele" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/ans-4175" > < img src = "https://avatars.githubusercontent.com/u/3961872?s=60&v=4" title = "ans-4175" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/lotas" > < img src = "https://avatars.githubusercontent.com/u/83861?s=60&v=4" title = "lotas" width = "50" height = "50" > < / a >
< a hrer = "https://github.com/ferrybig" > < img src = "https://avatars.githubusercontent.com/u/1576684?s=60&v=4" title = "ferrybig" width = "50" height = "50" > < / a >
< a hrer = "" > < img src = "https://avatars.githubusercontent.com/u/1001585?v=4" title = "" width = "50" height = "50" > < / a >
< a hrer = "" > < img src = "https://avatars.githubusercontent.com/u/508624?v=4" title = "" width = "50" height = "50" > < / a >
< a hrer = "" > < img src = "https://avatars.githubusercontent.com/u/8931?v=4" title = "" width = "50" height = "50" > < / a >
< a hrer = "" > < img src = "https://avatars.githubusercontent.com/u/26602940?v=4" title = "" width = "50" height = "50" > < / a >
- - - - - - -
