> ## Documentation Index > Fetch the complete documentation index at: https://docs.get-clara.tech/llms.txt > Use this file to discover all available pages before exploring further. # Yerel Kurulum > Twenty'i yerel olarak çalıştırmak isteyen katkıda bulunanlar (veya meraklı geliştiriciler) için kılavuz. ## Ön Gereksinimler Twenty'i yüklemeden ve kullanmadan önce bilgisayarınıza aşağıdakileri yüklediğinizden emin olun: * [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` çalışmaz, bunun yerine `yarn` kullanmalısınız. Yarn artık Node.js ile birlikte geliyor, bu yüzden ayrı bir yüklemeye gerek yoktur. Eğer henüz yapmadıysanız Yarn'ı etkinleştirmek için sadece `corepack enable` komutunu çalıştırmanız gerekiyor. 1. WSL Kurun PowerShell'i Yönetici olarak açın ve çalıştırın: ```powershell theme={null} wsl --install ``` Şimdi bilgisayarınızı yeniden başlatmanız gerektiğine dair bir uyarı göreceksiniz. Eğer görmüyorsanız, manuel olarak yeniden başlatın. Yeniden başlatıldığında bir PowerShell penceresi açılacak ve Ubuntu yüklenecek. Bu biraz zaman alabilir. Ubuntu kurulumunuz için bir kullanıcı adı ve şifre oluşturmanız gerektiğine dair bir uyarı göreceksiniz. 2. git'i Yükleyin ve Yapılandırın ```bash theme={null} sudo apt-get install git git config --global user.name "Adınız" git config --global user.email "emailiniz@alan.com" ``` 3. nvm, node.js ve yarn'ı Yükleyin Doğru `node` versiyonunu yüklemek için `nvm` kullanın. `.nvmrc` tüm katkıda bulunanların aynı versiyonu kullanmasını sağlar. ```bash theme={null} sudo apt-get install curl curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash ``` nvm'i kullanmak için terminalinizi kapatıp yeniden açın. Sonra aşağıdaki komutları çalıştırın. ```bash theme={null} nvm install # önerilen node versiyonunu yükler nvm use # önerilen node versiyonunu kullan corepack enable ``` *** ## Adım 1: Git Clone Terminalinizde aşağıdaki komutu çalıştırın. SSH anahtarlarını henüz kurmadıysanız, bunu nasıl yapacağınızı [buradan](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh) öğrenebilirsiniz. ```bash theme={null} git clone git@github.com:twentyhq/twenty.git ``` ```bash theme={null} git clone https://github.com/twentyhq/twenty.git ``` ## Adım 2: Kök Dizine Konuçlanın ```bash theme={null} cd twenty ``` Sonraki adımlardaki tüm komutları projenin kök dizininden çalıştırmalısınız. ## Adım 3: Bir PostgreSQL Veritabanı Kurun **Seçenek 1 (tercih edilen):** Veritabanınızı yerel olarak hazırlamak için: Linux makinenize PostgreSQL yüklemek için aşağıdaki bağlantıyı kullanın: [PostgreSQL Kurulumu](https://www.postgresql.org/download/linux/) ```bash theme={null} psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;" ``` Not: İzin hatalarından kaçınmak için `psql` komutundan önce `sudo -u postgres` eklemeniz gerekebilir. **Seçenek 2:** Eğer docker yüklüyse: ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` **Seçenek 1 (tercih edilen):** Veritabanınızı `brew` ile yerel olarak kurmak için: ```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 sunucusunun çalışıp çalışmadığını kontrol etmek için şu komutu çalıştırabilirsiniz: ```bash theme={null} brew services list ``` Yükleyici, macOS'ta Homebrew aracılığıyla yüklenirken varsayılan olarak `postgres` kullanıcısını oluşturmayabilir. Bunun yerine, macOS kullanıcı adınıza (ör. "john") uygun bir PostgreSQL rolü oluşturur. Gerekiyorsa `postgres` kullanıcısını kontrol etmek ve oluşturtmak için şu adımları izleyin: ```bash theme={null} # PostgreSQL'e Bağlan psql postgres or psql -U $(whoami) -d postgres ``` psql isteminde (postgres=#) şu komutu çalıştırın: ```bash theme={null} # Mevcut PostgreSQL rollerini listeleyin \du ``` Şu benzer bir çıktı göreceksiniz: ```bash theme={null} Rol adı | Özellikler | Üyesi olduğu -----------+-------------+----------- john | Superuser | {} ``` Eğer listede bir `postgres` rolü görmüyorsanız, bir sonraki adıma geçin. `postgres` rolünü manuel olarak oluşturun: ```bash theme={null} CREATE ROLE postgres WITH SUPERUSER LOGIN; ``` Bu, `postgres` adıyla giriş erişimi olan bir süper kullanıcı rolü oluşturur. ```bash theme={null} Rol adı | Özellikler | Üyesi olduğu -----------+-------------+----------- postgres | Superuser | {} john | Superuser | {} ``` **Seçenek 2:** Eğer docker yüklüyse: ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` Aşağıdaki tüm adımlar WSL terminalinde (sanallaştırma makineniz içinde) çalıştırılmalıdır. **Seçenek 1:** PostgreSQL'i yerel olarak hazırlamak için: Linux sanal makinenize PostgreSQL yüklemek için aşağıdaki bağlantıyı kullanın: [PostgreSQL Kurulumu](https://www.postgresql.org/download/linux/) ```bash theme={null} psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;" ``` Not: İzin hatalarından kaçınmak için `psql` komutundan önce `sudo -u postgres` eklemeniz gerekebilir. **Seçenek 2:** Eğer docker yüklüyse: WSL üzerinde Docker çalıştırmak ek bir karmaşıklık katmanı ekler. Yalnızca ek adımlar dahil olmak üzere extra karmaşıklık adımlarına aşinaysanız kullanın. [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl) etkinleştirmenizi içeren. ```bash theme={null} make -C packages/twenty-docker postgres-on-docker ``` Artık veritabanına `localhost:5432` üzerinden erişebilirsiniz. Yukarıdaki Docker seçeneğini kullandıysanız, varsayılan kimlik bilgileri kullanıcı adı `postgres` ve parola `postgres` şeklindedir. Yerel PostgreSQL kurulumları için, makinenizde yapılandırılmış kimlik bilgilerini ve rolleri kullanın. ## Adım 4: Redis Veritabanı (önbellek) Kurun Twenty, en iyi performansı sağlamak için bir Redis önbelleği gerektirir. **Seçenek 1:** Redis'i yerel olarak sağlamak için: Linux makinenize Redis yüklemek için şu bağlantıyı kullanın: [Redis Kurulumu](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/) **Seçenek 2:** Eğer docker yüklüyse: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` **Seçenek 1 (tercih edilen):** Redis'i `brew` ile yerel olarak sağlamak için: ```bash theme={null} brew install redis ``` Redis sunucunuzu başlatın: ```bash theme={null} brew services start redis ``` **Seçenek 2:** Eğer docker yüklüyse: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` **Seçenek 1:** Redis'i yerel olarak sağlamak için: Linux sanal makinenize Redis yüklemek için şu bağlantıyı kullanın: [Redis Kurulumu](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/) **Seçenek 2:** Eğer docker yüklüyse: ```bash theme={null} make -C packages/twenty-docker redis-on-docker ``` Bir istemci GUI'ye ihtiyacınız varsa, [Redis Insight](https://redis.io/insight/) (ücretsiz sürüm mevcut) öneriyoruz. ## Adım 5: Ortam değişkenlerini ayarlayın Projenizi yapılandırmak için çevresel değişkenler veya `.env` dosyaları kullanın. Daha fazla bilgi [burada](/l/tr/developers/self-host/capabilities/setup). `.env.example` dosyalarını `/front` ve `/server` içine kopyalayın: ```bash theme={null} cp ./packages/twenty-front/.env.example ./packages/twenty-front/.env cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env ``` **Çoklu Çalışma Alanı Modu:** Varsayılan olarak, Twenty yalnızca bir çalışma alanının oluşturulabildiği tek çalışma alanı modunda çalışır. Çoklu çalışma alanı desteğini etkinleştirmek için (alt alan adına dayalı özellikleri test etmek açısından kullanışlıdır), sunucunuzdaki `.env` dosyanızda `IS_MULTIWORKSPACE_ENABLED=true` değerini ayarlayın. Ayrıntılar için [Çoklu Çalışma Alanı Modu](/l/tr/developers/self-host/capabilities/setup#multi-workspace-mode) bölümüne bakın. ## Adım 6: Bağımlılıkların yüklenmesi Twenty server'ı oluşturup veritabanınıza bazı veriler yerleştirmek için aşağıdaki komutu çalıştırın: ```bash theme={null} yarn ``` `npm` veya `pnpm` çalışmaz ## Adım 7: Projeyi çalıştırma Dağıtımınıza bağlı olarak, Redis sunucusu otomatik olarak başlatılabilir. Değilse, dağıtımınız için [Redis Kurulum Kılavuzu](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) üzerinden kontrol edin. Redis zaten çalışıyor olmalıdır. Değilse, şu komutu çalıştırın: ```bash theme={null} brew services start redis ``` Dağıtımınıza bağlı olarak, Redis sunucusu otomatik olarak başlatılabilir. Değilse, dağıtımınız için [Redis Kurulum Kılavuzu](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) üzerinden kontrol edin. Veritabanınızı aşağıdaki komutla kurun: ```bash theme={null} npx nx database:reset twenty-server ``` Sunucuyu, çalışanı ve ön uç hizmetlerini başlatın: ```bash theme={null} npx nx start twenty-server npx nx worker twenty-server npx nx start twenty-front ``` Alternatif olarak, tüm hizmetleri aynı anda başlatabilirsiniz: ```bash theme={null} npx nx start ``` ## Adım 8: Twenty'yi kullanın **Ön Uç** Twenty'nin ön ucu [http://localhost:3001](http://localhost:3001) adresinde çalışıyor olacak. Varsayılan demo hesabıyla giriş yapabilirsiniz: `tim@apple.dev` (şifre: `tim@apple.dev`) **Arka Uç** * Twenty'nin sunucusu [http://localhost:3000](http://localhost:3000) adresinde çalışır durumda olacak * GraphQL API'sine [http://localhost:3000/graphql](http://localhost:3000/graphql) adresinden erişebilirsiniz. * REST API'sine [http://localhost:3000/rest](http://localhost:3000/rest) adresinden ulaşabilirsiniz. ## Sorun Giderme Herhangi bir sorunla karşılaşırsanız, çözümler için [Sorun Giderme](/l/tr/developers/self-host/capabilities/troubleshooting) sayfasına bakın.