메인 콘텐츠로 건너뛰기
Header

​
사전 준비

  • Linux and MacOS
  • Windows (WSL)
Twenty를 설치하고 사용하기 전에, 먼저 컴퓨터에 다음을 설치하세요:
npm은 사용할 수 없으며, 대신 yarn을 사용해야 합니다. Yarn은 이제 Node.js와 함께 제공되기 때문에 별도로 설치할 필요가 없습니다. 아직 하지 않았다면 corepack enable을 실행하여 Yarn을 사용할 수 있도록 설정하세요.

​
1단계: Git 복제

터미널에서 다음 명령어를 실행하세요.

​
2단계: 루트 위치 설정

cd twenty
다음 단계의 모든 명령어는 프로젝트 루트에서 실행하세요.

​
3단계: PostgreSQL 데이터베이스 설정

  • Linux
  • Mac OS
  • Windows (WSL)
Option 1 (preferred): To provision your database locally: Use the following link to install Postgresql on your Linux machine: Postgresql Installation
  psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
Note: You might need to add sudo -u postgres to the command before psql to avoid permission errors.
**Option 2:** If you have docker installed:
```bash
  make postgres-on-docker
```
이제 localhost:5432에서 데이터베이스에 액세스할 수 있으며, 사용자 postgres와 비밀번호 postgres 를 사용합니다.

​
4단계: Redis 데이터베이스 (캐시) 설정

Twenty는 최상의 성능을 제공하기 위해 redis 캐시가 필요합니다.
  • Linux
  • Mac OS
  • Windows (WSL)
Option 1: To provision your Redis locally: Use the following link to install Redis on your Linux machine: Redis Installation
**Option 2:** If you have docker installed:
```bash
  make redis-on-docker
```
클라이언트 GUI가 필요한 경우에는 redis insight (무료 버전 제공)을 권장합니다.

​
5단계: 환경 변수 설정

프로젝트를 구성하기 위해 환경 변수나 .env 파일을 사용하세요. 추가 정보는 여기에서 확인하십시오 /front와 /server의 .env.example 파일을 복사하세요: 
cp ./packages/twenty-front/.env.example ./packages/twenty-front/.env
cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env

​
6단계: 의존성 설치

Twenty 서버를 빌드하고 데이터베이스에 몇 가지 데이터를 시드하기 위해, 다음 명령어를 실행하세요: 
yarn
npm이나 pnpm은 작동하지 않음을 주의하세요.

​
7단계: 프로젝트 실행

  • Linux
  • Mac OS
  • Windows (WSL)
리눅스 배포판에 따라 Redis 서버가 자동으로 시작될 수 있습니다. 시작되지 않는다면, 각 배포판에 맞는 Redis 설치 가이드를 확인하세요.
다음 명령어로 데이터베이스를 설정하세요: 
npx nx database:reset twenty-server
서버, 워커 및 프론트엔드 서비스를 시작하세요: 
npx nx start twenty-server
npx nx worker twenty-server
npx nx start twenty-front
또한, 모든 서비스를 한 번에 시작할 수도 있습니다: 
npx nx start

​
8단계: Twenty 사용하기

프론트엔드 Twenty의 프론트엔드는 http://localhost:3001에서 실행됩니다. 기본 데모 계정을 사용하여 로그인할 수 있습니다: tim@apple.dev (비밀번호: tim@apple.dev) 백엔드

​
문제 해결

문제가 발생하면 문제 해결에서 해결책을 확인하십시오.