Express Kurulumu: Windows, macOS ve Linux’ta Nasıl Yapılır

Express Kurulumu Windows, macOS ve Linux sistemlerinde nasıl yapılır? Node.js, npm, Express Generator ve sunucu başlatma adımlarını örnek komutlarla öğrenin.

Express ile ilk web uygulamanızı hazırlamak istiyorsunuz ancak işletim sisteminize uygun kurulum adımlarını bulmakta zorlanıyor olabilirsiniz. Özellikle Node.js sürümü, npm komutları ve proje klasörünün hazırlanması sırasında yapılan küçük hatalar, uygulamanın başlamasını engelleyebiliyor. Express Kurulumu için karmaşık araçlara ihtiyacınız yok. Doğru sıralamayla ilerlemek yeterli.

Windows, macOS ve Linux sistemlerinde kullanılan temel komutlar büyük ölçüde aynı olsa da terminal kullanımı ve bazı başlangıç işlemleri farklılık gösteriyor. Express Kurulumu sırasında hangi dosyaların oluşturulduğunu ve sunucunun nasıl çalıştırıldığını bilmek, ileride karşılaşabileceğiniz sorunları çözmenizi de kolaylaştıracaktır.

Web uygulaması geliştirmek ile mevcut bir sitenin arama motorlarında görünmesini sağlamak birbirinden farklı süreçlerdir. Örneğin, WordPress Site Haritası Nedir ve Nasıl Oluşturulur içeriğinde, yayımlanan sayfaların arama motorları tarafından keşfedilmesini kolaylaştıran XML dosyalarının hazırlanması anlatılıyor. Express ise ziyaretçilerin isteklerini karşılayan sunucu tarafındaki yapıyı oluşturmanıza yardımcı oluyor.

Express Kurulumu Nasıl Yapılır?

Express Kurulumu için öncelikle bilgisayarınıza Node.js ve npm yükleyin. Ardından terminal üzerinden bir proje klasörü oluşturup npm init -y komutuyla yapılandırma dosyasını hazırlayın. npm install express komutunu çalıştırarak gerekli paketi ekleyin. Basit bir sunucu dosyası oluşturduktan sonra uygulamanızı başlatabilir ve tarayıcı üzerinden çalışıp çalışmadığını kontrol edebilirsiniz.

Express Nedir ve Ne İşe Yarar?

Express, Node.js üzerinde çalışan web uygulamaları ve API servisleri geliştirmek için kullanılan hafif bir framework’tür. JavaScript ile sunucu hazırlarken her HTTP işlemini sıfırdan yapılandırma ihtiyacını azaltır.

Örneğin, ziyaretçi belirli bir adrese girdiğinde hangi içeriğin gösterileceğini Express üzerinden tanımlayabilirsiniz. Middleware adı verilen ara katmanlar sayesinde gelen istekleri kontrol etmek, veri doğrulamak ve kimlik doğrulama işlemlerini düzenlemek de mümkündür.

Express, MySQL, PostgreSQL ve MongoDB gibi veritabanlarıyla birlikte kullanılabilir. Ancak kendi içerisinde hazır bir veritabanı bağlantısı veya ORM sistemi sunmaz. Bu işlemler için ek paketler gerekir.

Kurulum Öncesinde Neler Gerekli?

Express Kurulumu öncesinde bilgisayarınızda Node.js bulunmalıdır. Express 5 sürümü en az Node.js 18 gerektiriyor. 2026 itibarıyla yeni projelerde desteklenen bir Node.js LTS sürümünü tercih etmek daha uygun olacaktır.

İlk kontrolü terminal üzerinden yapabilirsiniz:

node -v
npm -v

Her iki komut da sürüm numarası gösteriyorsa temel hazırlık tamamlanmıştır. Komutlardan biri tanınmıyorsa Node.js kurulumunu veya sistemin PATH ayarlarını kontrol edin.

Windows’ta Express Kurulumu

Windows kullanıcıları işlemleri Komut İstemi ya da PowerShell üzerinden gerçekleştirebilir.

Öncelikle Node.js resmî indirme sayfasını açın. Windows için uygun yükleyiciyi indirerek kurulumu tamamlayın. Ardından yeni bir terminal penceresi açın.

Proje klasörünü oluşturmak için:

mkdir express-projem
cd express-projem
npm init -y
npm install express

Buradaki npm init -y komutu varsayılan ayarlarla package.json dosyasını oluşturur. Express ise mevcut proje klasörüne bağımlılık olarak eklenir.

Kurulumun ardından app.js adında bir dosya hazırlayın ve aşağıdaki kodları yerleştirin:

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Express sunucusu calisiyor');
});

app.listen(3000, () => {
  console.log('Sunucu 3000 portunda hazir');
});

Dosyayı kaydettikten sonra terminalde şu komutu çalıştırın:

node app.js

Tarayıcınızdan http://localhost:3000 adresine girin. Hazırladığınız mesaj görüntüleniyorsa sunucunuz çalışıyor demektir.

macOS’ta Express Kurulumu

Mac bilgisayarlarda işlem sırası Windows’a oldukça benzer. Aradaki temel fark, komutların Terminal uygulamasından çalıştırılmasıdır.

Node.js için resmî macOS yükleyicisini kullanabilirsiniz. Homebrew üzerinden kurulum yapmak da mümkündür.

Homebrew sisteminizde hazırsa:

brew install node

Ardından bir çalışma klasörü oluşturun:

mkdir express-mac
cd express-mac
npm init -y
npm install express

Express Kurulumu tamamlandığında Windows bölümündeki app.js örneğini bu klasörde de kullanabilirsiniz.

node app.js

Bu yöntemle işletim sistemine özel ayrı bir Express paketi aramanıza gerek kalmaz.

Linux’ta Express Kurulumu

Linux tarafında Node.js yükleme yöntemi kullanılan dağıtıma bağlıdır. Ubuntu veya Debian tabanlı sistemlerde paket yöneticisinden yararlanabilirsiniz:

sudo apt update
sudo apt install nodejs npm

Ancak dağıtım deposundaki Node.js sürümü eski olabilir. Yüklemeden sonra node -v komutuyla sürümü mutlaka kontrol edin.

Uyumlu sürüm hazırsa Express Kurulumu için şu komutları uygulayın:

mkdir express-linux
cd express-linux
npm init -y
npm install express

app.js dosyasına önceki örnekteki sunucu kodunu ekleyerek node app.js komutuyla uygulamayı başlatabilirsiniz.

Express Generator Kullanmak Gerekli mi?

Her projeyi boş klasörden hazırlamak istemeyebilirsiniz. Express Generator, başlangıç klasörlerini ve temel uygulama dosyalarını otomatik oluşturan yardımcı bir araçtır.

Windows, macOS ve Linux üzerinde şu komut kullanılabilir:

npx express-generator --view=pug ornek-uygulama
cd ornek-uygulama
npm install
npm start

Ardından http://localhost:3000 adresini ziyaret edin. Generator kullanımı isteğe bağlıdır; temel Express Kurulumu için zorunlu değildir.

Express Kurulumu Sonrasında Karşılaşılan Sorunlar

Sunucu açılmıyorsa öncelikle terminaldeki hata mesajını inceleyin. Cannot find module 'express' hatası genellikle ilgili proje klasöründe Express paketinin bulunmadığını gösterir.

EADDRINUSE hatası ise seçilen portun başka bir işlem tarafından kullanıldığını belirtir. Çalışan uygulamayı durdurabilir veya farklı bir port seçebilirsiniz.

Editör Notu: Resmî kurulum belgelerini incelerken özellikle iki komutun karıştırılmaya müsait olduğunu fark ettim. npm install express paketi projeye eklerken npx express-generator başlangıç dosyalarını oluşturur. Ayrıca npm start komutunun çalışabilmesi için package.json içerisinde uygun bir başlangıç betiği bulunmalıdır.

Kurulum veya bilgisayar yapılandırmasıyla ilgili teknik sorunlarda 11858 Teknoloji Destek Hattı üzerinden yardım alabilirsiniz. 2011 yılından bu yana Türkiye genelinde 7/24 hizmet veren 11858, bilgisayar ve bağlantı sorunlarında TeamViewer ile AnyDesk gibi lisanslı yazılımlar üzerinden uzaktan destek sağlıyor. Hizmet dakika bazlı ücretlendiriliyor.

Geliştirme ortamını hazırladıktan sonra web projenizi farklı bir adrese taşımayı da düşünebilirsiniz. Bu aşamada bağlantıların korunması önem kazanır. WordPress Alan Adı Değiştirme: SEO Kaybetmeden Nasıl Yapılır içeriği, özellikle mevcut sitelerin adres değişikliğinde dikkate alınması gereken yönlendirme ve SEO kontrollerini açıklıyor.

Express Kurulumu sırasında asıl kazanım, yalnızca çalışan bir sunucu elde etmek değil, Node.js uygulamasının nasıl yapılandırıldığını da anlamaktır. Siz Windows, macOS veya Linux sistemlerinden hangisini kullanıyorsunuz? Kurulum sırasında karşılaştığınız hataları yorumlarda paylaşabilirsiniz.