> ## Documentation Index > Fetch the complete documentation index at: https://docs.twenty.com/llms.txt > Use this file to discover all available pages before exploring further. # 로컬 설정 > 콘트리뷰터(기여자)나 호기심 많은 개발자를 위한 가이드로서, Twenty를 로컬에서 실행하고자 하는 분들에게 드리는 안내입니다. ## 사전 준비 Twenty를 설치하고 사용하기 전에, 먼저 컴퓨터에 다음을 설치하세요: * [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) * [Node v24.5.0](https://nodejs.org/en/download) * [yarn v4](https://yarnpkg.com/getting-started/install) * [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md) `npm`은 사용할 수 없으며, 대신 `yarn`을 사용해야 합니다. Yarn은 이제 Node.js와 함께 제공되기 때문에 별도로 설치할 필요가 없습니다. 아직 하지 않았다면 `corepack enable`을 실행하여 Yarn을 사용할 수 있도록 설정하세요. 1. WSL 설치 PowerShell을 관리자 권한으로 열고 다음을 실행하세요: ```powershell theme={null} wsl --install ``` 이제 컴퓨터를 재시작하라는 프롬프트가 나타날 것입니다. 그렇지 않으면 수동으로 재시작하세요. 다시 시작 후 PowerShell 창이 열리고 Ubuntu가 설치됩니다. 이 작업은 다소 시간이 걸릴 수 있습니다. Ubuntu 설치 시 사용자 이름과 암호를 만드는 프롬프트가 나타납니다. 2. Git 설치 및 구성 ```bash theme={null} sudo apt-get install git git config --global user.name "Your Name" git config --global user.email "youremail@domain.com" ``` 3. nvm, node.js 및 yarn 설치 적절한 `node` 버전을 설치하기 위해 `nvm`을 사용하세요. `.nvmrc`는 모든 기여자가 동일한 버전을 사용하도록 보장합니다. ```bash theme={null} sudo apt-get install curl curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash ``` nvm을 사용하려면 터미널을 닫았다가 다시 여세요. 그런 다음 다음 명령어를 실행하세요. ```bash theme={null} nvm install # installs recommended node version nvm use # use recommended node version corepack enable ``` *** ## 1단계: Git 복제 터미널에서 다음 명령어를 실행하세요. 아직 SSH 키를 설정하지 않은 경우, [여기](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh)를 참조하여 설정하는 방법을 배우세요. ```bash theme={null} git clone git@github.com:twentyhq/twenty.git ``` ```bash theme={null} git clone https://github.com/twentyhq/twenty.git ``` ## 2단계: 루트 위치 설정 ```bash theme={null} cd twenty ``` 다음 단계의 모든 명령어는 프로젝트 루트에서 실행하세요. ## 3단계: PostgreSQL 데이터베이스 설정 **옵션 1 (권장):** 데이터베이스를 로컬에서 프로비저닝하려면: Linux 머신에 PostgreSQL을 설치하려면 다음 링크를 사용하세요: [PostgreSQL 설치](https://www.postgresql.org/download/linux/) ```bash theme={null} psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;" ``` 참고: 권한 오류를 피하기 위해 `psql` 명령어 앞에 `sudo -u postgres`를 추가해야 할 수 있습니다. **옵션 2:** 도커가 설치된 경우: ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` **옵션 1 (권장):** `brew`로 로컬에서 데이터베이스를 프로비저닝하려면: ```bash theme={null} brew install postgresql@16 export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH" brew services start postgresql@16 psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;" ``` PostgreSQL 서버가 실행 중인지 확인하려면 다음을 실행하세요: ```bash theme={null} brew services list ``` macOS에서 Homebrew로 설치할 때 설치 프로그램이 기본적으로 `postgres` 사용자를 생성하지 않을 수 있습니다. 대신 사용자의 macOS 사용자 이름(예: "john")과 일치하는 PostgreSQL 역할을 생성합니다.# PostgreSQL 접속psql postgres 또는 psql -U \$(whoami) -d postgres ```bash theme={null} # Connect to PostgreSQL psql postgres or psql -U $(whoami) -d postgres ``` psql 프롬프트에서(postgres=#), 다음을 실행하세요: ```bash theme={null} # List existing PostgreSQL roles \du ``` 출력은 다음과 비슷해야 합니다: ```bash theme={null} Role name | Attributes | Member of -----------+-------------+----------- john | Superuser | {} ``` `postgres` 역할이 나열되지 않으면 다음 단계를 계속하십시오. `postgres` 역할을 수동으로 만드세요: ```bash theme={null} CREATE ROLE postgres WITH SUPERUSER LOGIN; ``` 이는 로그인 액세스가 있는 슈퍼유저 역할 `postgres`를 생성합니다. ```bash theme={null} Role name | Attributes | Member of -----------+-------------+----------- postgres | Superuser | {} john | Superuser | {} ``` **옵션 2:** 도커가 설치된 경우: ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` 다음 단계는 모두 WSL 터미널(가상 머신 내)에서 실행됩니다. **옵션 1:** PostgreSQL을 로컬에서 프로비저닝하려면: Linux 가상 머신에 PostgreSQL을 설치하려면 다음 링크를 사용하세요: [PostgreSQL 설치](https://www.postgresql.org/download/linux/) ```bash theme={null} psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;" ``` 참고: 권한 오류를 피하기 위해 `psql` 명령어 앞에 `sudo -u postgres`를 추가해야 할 수 있습니다. **옵션 2:** 도커가 설치된 경우: WSL에서 Docker를 실행하면 추가적인 복잡성이 발생합니다. 이 옵션은 [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl)를 켠 상태에서의 추가 설정 단계를 수반할 수 있다는 점에서 편안할 때만 사용하십시오. ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` 이제 `localhost:5432`에서 데이터베이스에 접속할 수 있습니다. 위의 Docker 옵션을 사용했다면, 기본 자격 증명은 사용자 `postgres`와 비밀번호 `postgres`입니다. 네이티브 PostgreSQL 설치의 경우, 로컬 머신에 구성된 자격 증명과 역할을 사용하세요. ## 4단계: Redis 데이터베이스 (캐시) 설정 Twenty는 최상의 성능을 제공하기 위해 Redis 캐시가 필요합니다. **옵션 1:** Redis를 로컬에서 프로비저닝하려면: 리눅스 기기에 Redis를 설치하려면 다음 링크를 사용하십시오: [Redis 설치](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/) **옵션 2:** 도커가 설치된 경우: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` **옵션 1 (권장):** `brew`로 Redis를 로컬에서 프로비저닝하려면: ```bash theme={null} brew install redis ``` Redis 서버를 시작하세요: ```bash theme={null} brew services start redis ``` **옵션 2:** 도커가 설치된 경우: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` **옵션 1:** Redis를 로컬에서 프로비저닝하려면: Linux 가상 머신에 Redis를 설치하려면 다음 링크를 사용하세요: [Redis 설치](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/) **옵션 2:** 도커가 설치된 경우: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` 클라이언트 GUI가 필요하다면 [Redis Insight](https://redis.io/insight/)를 권장합니다(무료 버전 제공). ## 5단계: 환경 변수 설정 프로젝트를 구성하기 위해 환경 변수나 `.env` 파일을 사용하세요. 자세한 내용은 [여기](/l/ko/developers/self-host/capabilities/setup)에서 확인하세요. `/front`와 `/server`의 `.env.example` 파일을 복사하세요: ```bash theme={null} cp ./packages/twenty-front/.env.example ./packages/twenty-front/.env cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env ``` **멀티 워크스페이스 모드:** 기본적으로 Twenty는 하나의 워크스페이스만 생성할 수 있는 단일 워크스페이스 모드로 실행됩니다. 멀티 워크스페이스 지원을 활성화하려면(서브도메인 기반 기능을 테스트할 때 유용합니다), 서버의 `.env` 파일에서 `IS_MULTIWORKSPACE_ENABLED=true`로 설정하세요. 자세한 내용은 [멀티 워크스페이스 모드](/l/ko/developers/self-host/capabilities/setup#multi-workspace-mode)를 참조하세요. ## 6단계: 의존성 설치 Twenty 서버를 빌드하고 데이터베이스에 몇 가지 데이터를 시드하기 위해, 다음 명령어를 실행하세요: ```bash theme={null} yarn ``` `npm`이나 `pnpm`은 작동하지 않음을 주의하세요. ## 7단계: 프로젝트 실행 리눅스 배포판에 따라 Redis 서버가 자동으로 시작될 수 있습니다. 시작되지 않는다면, 각 배포판에 맞는 [Redis 설치 가이드](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/)를 확인하세요. Redis가 이미 실행 중이어야 합니다. 그렇지 않으면 다음을 실행하세요: ```bash theme={null} brew services start redis ``` 리눅스 배포판에 따라 Redis 서버가 자동으로 시작될 수 있습니다. 시작되지 않는다면, 각 배포판에 맞는 [Redis 설치 가이드](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/)를 확인하세요. 다음 명령어로 데이터베이스를 설정하세요: ```bash theme={null} npx nx database:reset twenty-server ``` 서버, 워커 및 프론트엔드 서비스를 시작하세요: ```bash theme={null} npx nx start twenty-server npx nx worker twenty-server npx nx start twenty-front ``` 또한, 모든 서비스를 한 번에 시작할 수도 있습니다: ```bash theme={null} npx nx start ``` ## 8단계: Twenty 사용하기 **프론트엔드** Twenty의 프론트엔드는 [http://localhost:3001](http://localhost:3001)에서 실행됩니다. 기본 데모 계정을 사용하여 로그인할 수 있습니다: `tim@apple.dev` (비밀번호: `tim@apple.dev`) **백엔드** * Twenty의 서버는 [http://localhost:3000](http://localhost:3000)에서 실행됩니다. * GraphQL API는 [http://localhost:3000/graphql](http://localhost:3000/graphql)에서 액세스할 수 있습니다 * REST API는 [http://localhost:3000/rest](http://localhost:3000/rest)에서 액세스할 수 있습니다 ## 문제 해결 문제가 발생하면 [문제 해결](/l/ko/developers/self-host/capabilities/troubleshooting)에서 해결책을 확인하십시오.