Strapi 5 Kurulum ve Sistem Gereksinimleri

Strapi 5 Kurulum ve Sistem Gereksinimleri

Strapi, modern web geliştirme dünyasında hızla popülerlik kazanan, açık kaynaklı ve lider bir “Headless CMS” (Sunucusuz İçerik Yönetim Sistemi) çözümüdür. Geliştiricilere esneklik, hız ve tam kontrol sunan Strapi, API tabanlı yapısıyla React, Next.js, Vue, Angular gibi tüm modern frontend teknolojileriyle kusursuz bir uyum içinde çalışır. Strapi 5’in gelişiyle birlikte performans, geliştirici deneyimi ve özellik setinde önemli iyileştirmeler sunuluyor.

Bu kapsamlı rehberde, Strapi 5 projenizi başarıyla hayata geçirmek için bilmeniz gereken sistem gereksinimlerini ve adım adım kurulum sürecini detaylı bir şekilde ele alacağız.

Strapi Nedir? Neden Tercih Edilmelidir?

Geleneksel CMS’lerin (WordPress gibi) aksine, bir “headless CMS” olan Strapi, içeriğin sunum katmanından (frontend) tamamen bağımsızdır. Bu ne anlama gelir?

  • API Odaklı: İçeriğinizi oluşturur ve Strapi bunu REST veya GraphQL API’leri aracılığıyla sunar.
  • Teknoloji Bağımsızlığı: İstediğiniz herhangi bir frontend teknolojisiyle (web sitesi, mobil uygulama, IoT cihazı) bu veriyi kullanabilirsiniz.
  • Geliştirici Odaklı: %100 JavaScript tabanlı olması, modern geliştiricilerin hızla adapte olmasını sağlar.
  • Özelleştirilebilirlik: Yönetim panelinden API’lere kadar her şeyi projenizin ihtiyacına göre kolayca özelleştirebilirsiniz.

Strapi 5, bu temel felsefeyi daha da ileri taşıyarak daha optimize bir çekirdek, gelişmiş bir kullanıcı arayüzü ve daha güçlü eklenti altyapısı sunmaktadır.

Strapi 5 İçin Gerekli Sistem Gereksinimleri

Kuruluma geçmeden önce, geliştirme ve sunucu ortamınızın aşağıdaki gereksinimleri karşıladığından emin olmanız kritik öneme sahiptir.

1. Node.js Sürümü

Strapi, Node.js çalışma zamanı ortamı üzerinde çalışır. Strapi 5, en güncel ve uzun süreli destek (LTS) sürümlerini hedeflemektedir.

  • Tavsiye Edilen Node.js Sürümleri:
    • Node.js 20.x (LTS) – En stabil ve önerilen sürüm.
    • Node.js 18.x (LTS)
  • Desteklenmeyen Sürümler: Node.js 16.x ve daha eski sürümler desteklenmemektedir.

Terminalinize aşağıdaki komutu yazarak mevcut Node.js sürümünüzü kontrol edebilirsiniz:

Bash

node -v

2. Paket Yöneticisi

Proje bağımlılıklarını yönetmek için npm veya yarn kullanabilirsiniz.

  • npm: v9 veya üstü (Genellikle Node.js ile birlikte gelir)
  • yarn: v1.22.x veya üstü

3. Veritabanı (Database)

Strapi 5, projenizin ihtiyaçlarına göre seçebileceğiniz çeşitli veritabanlarını destekler.

  • PostgreSQL: 12.x ve üstü (Performans ve ölçeklenebilirlik için kesinlikle tavsiye edilir.)
  • MySQL: 8.x ve üstü
  • MariaDB: 10.6 ve üstü
  • SQLite: 3.x (Sadece yerel geliştirme ve küçük projeler için önerilir, canlı (production) ortamlar için uygun değildir.)

4. İşletim Sistemi

Strapi, başlıca tüm modern işletim sistemlerinde sorunsuz çalışır:

  • Ubuntu / Debian
  • macOS
  • Windows (Geliştirme için WSL 2 – Windows Subsystem for Linux kullanılması tavsiye edilir.)

Adım Adım Strapi 5 Kurulumu

Sistem gereksinimlerini karşıladığınızdan emin olduktan sonra, kurulum işlemine başlayabiliriz. Strapi, komut satırı arayüzü (CLI) sayesinde bu süreci oldukça basitleştirmiştir.

Adım 1: Yeni Proje Oluşturma

Terminalinizi veya komut istemcinizi açın ve projenizi oluşturmak istediğiniz dizine gidin. Ardından aşağıdaki komutu çalıştırın. Bu komut, en son Strapi sürümünü kullanarak my-strapi5-project adında yeni bir proje klasörü oluşturacaktır.

Bash

npx create-strapi-app@latest my-strapi5-project

Bu komut size bir kurulum sihirbazı sunacaktır. Burada projeniz için temel ayarları yapabilirsiniz:

  1. Kurulum Türü (Installation type):Quickstart (hızlı başlangıç) veya Custom (özel) seçeneğini seçin.
    • Quickstart: Otomatik olarak SQLite veritabanı ile hızlı bir kurulum yapar. Yeni başlayanlar için idealdir.
    • Custom: Hangi veritabanını (PostgreSQL, MySQL vb.) kullanacağınızı ve diğer ayarları manuel olarak seçmenizi sağlar. Canlıya alınacak projeler için bu seçenek önerilir.

Eğer Quickstart ile başlamak isterseniz, komutu şu şekilde de çalıştırabilirsiniz:

Bash

npx create-strapi-app@latest my-strapi5-project --quickstart

Adım 2: Projeyi Çalıştırma

Kurulum tamamlandıktan sonra projenizin klasörüne gidin ve geliştirme sunucusunu başlatın.

Bash

cd my-strapi5-project
npm run develop

veya yarn kullanıyorsanız:

Bash

cd my-strapi5-project
yarn develop

Bu komut, projenizi derleyecek ve geliştirme modunda çalıştıracaktır. İşlem tamamlandığında, Strapi yönetim panelinin genellikle http://localhost:1337/admin adresinde hazır olduğunu göreceksiniz.

Adım 3: Yönetici (Admin) Hesabı Oluşturma

Tarayıcınızda http://localhost:1337/admin adresine gidin. Karşınıza ilk yönetici hesabınızı oluşturmanız için bir kayıt formu çıkacaktır. Gerekli bilgileri (isim, e-posta, şifre) doldurarak yönetici hesabınızı oluşturun.

Tebrikler! Strapi 5 projenizi başarıyla kurdunuz ve yönetim paneline eriştiniz. Artık içerik tiplerinizi (Content-Types) oluşturmaya, verilerinizi girmeye ve API’lerinizi yapılandırmaya başlayabilirsiniz.

Sıkça Sorulan Sorular (SSS)

S: Strapi 4’ten Strapi 5’e yükseltme yapabilir miyim? C: Evet, Strapi ekibi genellikle sürüm yükseltmeleri için detaylı migrasyon rehberleri yayınlar. Resmi Strapi dokümantasyonunu takip ederek projenizi güvenli bir şekilde v5’e yükseltebilirsiniz.

S: Hangi veritabanını seçmeliyim? C: Canlıya alacağınız (production) tüm projeler için kesinlikle PostgreSQL önerilir. Performansı, ölçeklenebilirliği ve gelişmiş özellikleriyle Strapi için en iyi seçenektir. Yerel geliştirme veya çok küçük demolar için SQLite yeterli olabilir.

S: Strapi 5 ücretli mi? C: Strapi’nin temel sürümü (Community Edition) tamamen açık kaynaklı ve ücretsizdir. Kendi sunucunuzda barındırabilir ve özgürce kullanabilirsiniz. Daha gelişmiş özellikler (RBAC, SSO vb.) ve kurumsal destek sunan ücretli planları (Enterprise Edition) da mevcuttur.

Strapi 5, geliştiricilere sunduğu esneklik, performans ve modern altyapı ile API tabanlı projeler için mükemmel bir temel oluşturuyor. Bu rehberde paylaştığımız sistem gereksinimleri ve kurulum adımlarını takip ederek siz de Strapi 5 ile projenizi hızlı ve sorunsuz bir şekilde hayata geçirebilirsiniz. Artık içeriğinizi yönetmek ve onu istediğiniz platforma sunmak tamamen sizin kontrolünüzde.

Leave A Comment