| NC_DB | Yes | See our database URLs | A local SQLite will be created in root folder |
| `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| |
| `DATABASE_URL`| No | JDBC URL Format. Can be used instead of `NC_DB`. Used in 1-Click Heroku deployment| |
| DATABASE_URL_FILE | No | path to file containing JDBC URL Format. Can be used instead of NC_DB. Used in 1-Click Heroku deployment| |
| `DATABASE_URL_FILE` | No | path to file containing 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_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_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_SENTRY_DSN`| No | For Sentry monitoring| |
| NC_CONNECT_TO_EXTERNAL_DB_DISABLED | No | Disable Project creation with external database | |
| `NC_CONNECT_TO_EXTERNAL_DB_DISABLED` | No | Disable Project creation with external database| |
| NC_DISABLE_TELE | No | Disable telemetry | |
| `NC_DISABLE_TELE` | No | Disable telemetry | |
| NC_BACKEND_URL | No | Custom Backend URL | ``http://localhost:8080`` will be used |
| `NC_BACKEND_URL` | No | Custom Backend URL | ``http://localhost:8080`` will be used |
# Development setup
# Development setup
```
```shell
git clone https://github.com/nocodb/nocodb
git clone https://github.com/nocodb/nocodb
cd nocodb
cd nocodb
@ -250,8 +234,6 @@ npm install
# run required services by using docker compose
# run required services by using docker compose
docker-compose -f ./docker-compose-cypress.yml up
docker-compose -f ./docker-compose-cypress.yml up
# wait until both 3000 and 8080 porta are avalable
# wait until both 3000 and 8080 porta are avalable
# and run cypress test using following command
# and run cypress test using following command
npm run cypress:run
npm run cypress:run
@ -261,10 +243,10 @@ npm run cypress:open
```
```
# Contributing
# Contributing
- Please take a look at ./contribute/HowToApplyLicense.md
- Please take a look at `./contribute/HowToApplyLicense.md`
- Ignore adding headers for .json or .md or .yml
- Ignore adding headers for `.json` or `.md` or `.yml`
# 🎯 Why are we building this?
# 🎯 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 a 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 has meant horrible access controls, vendor lockin, data lockin, abrupt price changes & most importantly a glass ceiling on what's possible in future.
Most internet businesses equip themselves with either spreadsheet or a database to solve their business needs. Spreadsheets are used by a 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 has meant horrible access controls, vendor lockin, data lockin, abrupt price changes & most importantly a glass ceiling on what's possible in future.
<ahref="https://www.producthunt.com/posts/nocodb?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-nocodb"target="_blank"><imgsrc="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=297536&theme=dark"alt="NocoDB - The Open Source Airtable alternative | Product Hunt"style="width: 250px; height: 54px;"width="250"height="54"/></a>
<ahref="https://www.producthunt.com/posts/nocodb?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-nocodb"target="_blank"><imgsrc="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=297536&theme=dark"alt="NocoDB - The Open Source Airtable alternative | Product Hunt"style="width: 250px; height: 54px;"width="250"height="54"/></a>
| NC_DB | Yes | See our database URLs | A local SQLite will be created in root folder |
| `NC_DB` | Yes | 제품이 사용할 데이터베이스 URL | 루트 디렉터리에 SQLite DB 생성 |
| DATABASE_URL | No | JDBC URL Format. Can be used instead of NC_DB. Used in 1-Click Heroku deployment| |
| `DATABASE_URL` | No | JDBC URL 형식. `NC_DB` 대신 사용 가능. Heroku 원클릭 배포에 사용 | |
| DATABASE_URL_FILE | No | path to file containing JDBC URL Format. Can be used instead of NC_DB. Used in 1-Click Heroku deployment| |
| `DATABASE_URL_FILE` | No | JDBC URL을 담은 파일의 경로. `NC_DB` 대신 사용 가능. Heroku 원클릭 배포에 사용 | |
| NC_PUBLIC_URL | Yes | Used for sending Email invitations | Best guess from http request params |
| `NC_PUBLIC_URL` | Yes | 이메일 초대에 사용 | HTTP 요청 파라미터를 통해 추정 |
| NC_AUTH_JWT_SECRET | Yes | JWT secret used for auth and storing other secrets | A Random secret will be generated |
| `NC_AUTH_JWT_SECRET` | Yes | 인증 및 다른 비밀 값을 저장할 때 사용할 JWT 시크릿 키 | 임의의 시크릿 키 생성 |
| NC_SENTRY_DSN | No | For Sentry monitoring | |
| `NC_SENTRY_DSN` | No | Sentry 모니터링용 | |
| NC_CONNECT_TO_EXTERNAL_DB_DISABLED | No | Disable Project creation with external database | |
| `NC_CONNECT_TO_EXTERNAL_DB_DISABLED` | No | 외부 데이터베이스와 연동된 프로젝트를 생성하지 않음 | |
| NC_DISABLE_TELE | No | Disable telemetry | |
| `NC_DISABLE_TELE` | No | 사용 정보를 수집하지 않음 | |
| NC_BACKEND_URL | No | Custom Backend URL | ``http://localhost:8080`` will be used |
| `NC_BACKEND_URL` | No | 커스텀 백엔드 URL | `http://localhost:8080` 사용 |
# Development setup
# 개발 환경에 설치하기
```
```shell
git clone https://github.com/nocodb/nocodb
git clone https://github.com/nocodb/nocodb
cd nocodb
cd nocodb
# run backend
# 백엔드 실행
cd packages/nocodb
cd packages/nocodb
npm install
npm install
npm run watch:run
npm run watch:run
# open localhost:8080/dashboard in browser
# 브라우저에서 localhost:8080/dashboard 열기
# run frontend
# 프론트엔드 실행
cd packages/nc-gui
cd packages/nc-gui
npm install
npm install
npm run dev
npm run dev
# open localhost:3000/dashboard in browser
# 브라우저에서 localhost:3000/dashboard 열기
```
```
Changes made to code automatically restart.
코드 변경후 자동으로 재시작됩니다.
## Running Cypress tests locally
## 로컬에서 Cypress 테스트 돌리기
```shell
```shell
# install dependencies(cypress)
# 의존성(cypress) 설치
npm install
npm install
# run required services by using docker compose
# docker compose로필요한 서비스 실행
docker-compose -f ./docker-compose-cypress.yml up
docker-compose -f ./docker-compose-cypress.yml up
# 3000 포트와 8080 포트가 모두 열릴 때까지 대기
# 이후 다음 명령으로 cypress 실행
# wait until both 3000 and 8080 porta are avalable
# and run cypress test using following command
npm run cypress:run
npm run cypress:run
# or run following command to run it with GUI
# 또는 다음 명령으로 GUI로 실행
npm run cypress:open
npm run cypress:open
```
```
# Contributing
# 기여하기
- Please take a look at ./contribute/HowToApplyLicense.md
- 먼저 `./contribute/HowToApplyLicense.md`를 읽기
- Ignore adding headers for .json or .md or .yml
- `.json`, `.md`, `.yml` 파일에는 헤더를 추가하지 않아도 됨
# 🎯 왜 우리가 이것을 구축하고 있니?
# 🎯 왜 이걸 만들었나요?
대부분의 인터넷 비즈니스는 비즈니스 요구 사항을 해결하기 위해 스프레드 시트 또는 데이터베이스를 장비합니다. 스프레드 시트는 하루에 매일 30 억 + 인간이 사용됩니다. 그러나 우리는 컴퓨팅에 관해보다 강력한 도구가 더 강력한 데이터베이스에서 유사한 속도로 작동하는 방법이 있습니다. SaaS offices 로이 문제를 해결하려는 시도는 끔찍한 액세스 제어, 공급 업체 잠금, 데이터 잠금, 갑작스런 가격 변경 및 가장 중요한 것은 가능할 수있는 유리 천장입니다.
대부분의 인터넷 비즈니스는 업무상의 요구사항을 해결하기 위해 스프레드시트 또는 데이터베이스를 사용합니다. 스프레드시트는 매일 하루에 수십억 명 이상이 함께 사용합니다. 그러나 우리는 컴퓨팅에 관한 한 훨씬 강력한 도구인 데이터베이스는 별로 그만큼 사용하고 있지 않습니다. 이 문제를 SaaS로 해결하려는 시도는 끔찍한 접근 통제, 특정 업체 종속, 데이터 종속, 급격한 가격 변동, 그리고 무엇보다도 미래의 가능성을 스스로 가둬버리는 것을 의미합니다.
# ❤ 우리의 미션 :
# ❤ 우리의 사명
우리의 임무는 세계에서 모든 단일 인터넷 사업에 오픈 소스 인 데이터베이스에 가장 강력한 코드 인터페이스를 제공하는 것입니다. 이것은 강력한 컴퓨팅 도구에 대한 액세스를 민주화 할뿐만 아니라 인터넷에 급진적 인 땜질 / 건물 능력을 갖게 될 10 억 + 사람들을 이끌어냅니다.
우리의 사명은 이 세상의 모든 인터넷 비즈니스를 위해 가장 강력한 노코드(No-Code) 데이터베이스 인터페이스를 오픈소스로 제공하는 것입니다. 이는 단지 강력한 컴퓨팅 도구를 대중화하는 데 그치는 것이 아니라, 인터넷 상에서 뭐든 이어붙이고 만들 수 있는 급진적인 능력을 수십억 사람들에게 가져다주게 될 것입니다.