Adım 1
Kurulumu kimin yapacağına karar verin.
Kurulumu bizim yapmamızı isterseniz iletisim@fabrikode.com adresine yazın.
Bu rehber, WaterForm'u bizim sunucumuz yerine kendi sunucusunda çalıştırmak isteyen şirketler içindir. Komut satırında çalışmaya alışkın biri kurulumu bir saatte bitirir.
Program sunucuda çalışır; çalışanlarınız onu tarayıcıdan ya da masaüstü uygulamasından açar. Verileriniz kendi sunucunuzda kalır.
Adım 2
Gerekenleri hazırlayın.
Docker ve Docker Compose kurulu bir Linux sunucu. 2 işlemci çekirdeği ve 4 GB bellek yeterlidir.
Bir alan adı, örneğin wf.example.com, sunucunuzun IP adresine yönlendirilmiş olmalı. Sunucunun 80 ve 443 numaralı kapıları dışarıya açık olmalı; güvenlik sertifikası kendiliğinden alınır. Sunucuya yalnız şirket ağınızdan erişilecekse önce bize yazın; o durumda ayar farklıdır.
Bizden gelenler: kurulum dosyaları (compose.yaml, Caddyfile ve env.example), programı indirmek için bir kullanıcı adı ve erişim anahtarı, lisans dosyanız ve kısa bir şirket kodu, örneğin musteri.
3
Adım 3
Kurulum dosyalarını sunucuya koyun.
Sunucuda WaterForm için bir klasör ve içinde license adlı bir alt klasör açın. Size gönderdiğimiz üç kurulum dosyasını ana klasöre, lisans dosyanızı license klasörüne license.json adıyla kopyalayın. Sonra klasöre geçip içine bakın:
```
mkdir -p /opt/waterform/license
cd /opt/waterform
ls . license
```
Ne görmelisiniz
Listede compose.yaml, Caddyfile, env.example ve license klasörü, onun altında license.json görünür.
4
Adım 4
Sunucuya programı indirme izni verin.
Program özel bir depodan indirilir. Sunucuyu size gönderdiğimiz kullanıcı adıyla bir kez tanıtın. Parola sorulunca erişim anahtarını yapıştırın; ekranda görünmez, bu normaldir.
```
docker login ghcr.io -u KULLANICI-ADI
```
Ne görmelisiniz
“Login Succeeded” yazar.
5
Adım 5
Ayar dosyasını oluşturun ve açın.
Ayarlar .env adlı bir dosyada durur. İlk komut örnek dosyayı bu adla kopyalar. İkinci komut, bir sonraki adımda kullanacağınız rastgele bir satır üretir; onu bir kenara kopyalayın. Üçüncü komut dosyayı açar.
```
cp env.example .env
openssl rand -base64 32
nano .env
```
Ne görmelisiniz
openssl komutu 44 karakterlik tek bir satır verir. Sonra dosya ekranda açılır.
Adım 6
Ayar dosyasındaki beş satırı doldurun.
WF_SITE_ADDRESS: programın açılacağı adres, örneğin wf.example.com.
POSTGRES_PASSWORD: veritabanı için uzun ve rastgele bir parola. Kimseye söylemeniz gerekmez, ama bir yere not edin.
WF_SESSION_SECRET: openssl komutunun verdiği satır. Bir kez yazın ve değiştirmeyin; değişirse herkesin oturumu kapanır.
WF_LICENSE_FILE satırının başındaki # işaretini silin; satır WF_LICENSE_FILE=/app/license/license.json olarak kalır. Böylece program lisans dosyanızı okur.
WF_MODE onprem olarak kalır. Diğer satırlara dokunmayın. Kaydedip çıkmak için Ctrl+O, Enter ve Ctrl+X tuşlarına basın.
7
Adım 7
WaterForm'u başlatın.
İlk komut programı indirir, ikincisi başlatır. Veritabanı ilk açılışta kendiliğinden hazırlanır.
```
docker compose --env-file .env -f compose.yaml pull
docker compose --env-file .env -f compose.yaml up -d
```
Ne görmelisiniz
Dört hizmetin her biri için bir satır çıkar: db, web, caddy ve backup. Her birinin sonunda “Started” ya da “Running” yazar.
8
Adım 8
Çalıştığını denetleyin.
Bir iki dakika bekleyin. Tarayıcıda https://wf.example.com/api/health adresini açarsanız içinde "ok":true geçen kısa bir satır görürsünüz.
Sunucuda da hizmetlerin durumunu sorun:
```
docker compose ps
```
Ne görmelisiniz
web satırında “healthy” yazar.
9
Adım 9
Şirketinizi ve ilk yöneticiyi oluşturun.
Şirketinizi ve ilk yöneticisini tek bir komutla açarsınız. Bu kişi daha sonra çalışma arkadaşlarını programın içinden ekler. Tırnak içindeki değerleri kendi bilgilerinizle değiştirin.
Şirket kodu (slug) olarak size gönderdiğimiz kodu yazın; lisans dosyanız bu koda bağlıdır. Parola en az 10 karakter olmalıdır.
```
docker compose exec web node scripts/setup.mjs \
  --org "Şirketinizin Adı A.Ş." --slug musteri \
  --email yonetici@example.com --name "Ad Soyad" \
  --password "en az 10 karakterlik parola"
```
Ne görmelisiniz
Üç satır çıkar. Sonuncusu “setup: administrator yonetici@example.com created” ile başlar.
Adım 10
Oturum açın ve şirketinizi kurun.
Tarayıcıda https://wf.example.com adresini açın. Az önce yazdığınız e-posta ve parolayla oturum açın.
Bundan sonrası bizim sunucumuzdakiyle aynıdır: “Şirketinizi kurun” ve “İlk depo tipinizi tanımlayın” rehberlerini izleyin.
Teklif bildirimleri için Ayarlar'da “Bildirim ve talepler” bölümünde “Kendi SMTP sunucumuz” seçeneğini kullanın ve kendi e-posta sunucunuzun bilgilerini girin. “Fabrikode üzerinden” seçeneği bu kurulumda yoktur.
Ne görmelisiniz
Konfigüratör açılır; üst çubukta şirketinizin adı yazar.
11
Adım 11
Yedeğin nerede durduğunu bilin.
Kurulumla gelen yedek hizmeti her gece veritabanının bir kopyasını alır ve on dört gün saklar. Kopyalar db-backups adlı Docker biriminde, waterform-TARİH-SAAT.dump adıyla durur.
Aynı sunucudaki bir kopya gerçek bir yedek değildir: sunucu bozulursa kopyalar da gider. Bu dosyaları kendi yedekleme düzeninizle her gün başka bir yere taşıyın. Logolar ve yüklediğiniz Excel şablonları web-files biriminde durur; onu da yedeğinize ekleyin.
Kopyaların listesini görmek için:
```
docker compose exec backup ls -l /backups
```
Ne görmelisiniz
Her gece için bir .dump dosyası listelenir.
12
Adım 12
Yeni sürüme güncelleyin.
Yeni bir sürüm çıktığında size haber veririz. Veritabanı değişiklikleri program açılırken kendiliğinden uygulanır. Yeni sürüm sorun çıkarırsa bize yazın; önceki sürüme nasıl döneceğinizi söyleriz.
Güncellemeden önce son yedeğin alındığından emin olun. Sonra aynı klasörde iki komut yeter:
```
docker compose --env-file .env -f compose.yaml pull
docker compose --env-file .env -f compose.yaml up -d
```
Ne görmelisiniz
Bir iki dakika sonra docker compose ps komutunda web yeniden “healthy” olur.
Adım 13
Masaüstü uygulamasını kendi sunucunuza bağlayın.
Masaüstü uygulamasını waterform.fabrikode.com/downloads sayfasından indirirsiniz. İlk açılışta hangi sunucuyu kullanacağını sorar.
“Sunucu adresi” penceresinde “Adres” alanına https://wf.example.com yazın ve “Bağlan” düğmesine basın.
Uygulama daha önce başka bir sunucuya bağlandıysa adresi menüden değiştirirsiniz: macOS'ta “WaterForm” menüsünde, Windows ve Linux'ta “Dosya” menüsünde “Sunucu…” komutu vardır.
Ne görmelisiniz
Giriş sayfası açılır. Uygulama bu adresi hatırlar.

Takıldığınız bir yer mi var? Bize yazın, aynı gün içinde yanıt vermeye çalışırız: iletisim@fabrikode.com

Bütün rehberlerSon kontrol: 24 Eylül 2026

Kurulumu kimin yapacağına karar verin.

Gerekenleri hazırlayın.

Kurulum dosyalarını sunucuya koyun.

Sunucuya programı indirme izni verin.

Ayar dosyasını oluşturun ve açın.

Ayar dosyasındaki beş satırı doldurun.

WaterForm'u başlatın.

Çalıştığını denetleyin.

Şirketinizi ve ilk yöneticiyi oluşturun.

Oturum açın ve şirketinizi kurun.

Yedeğin nerede durduğunu bilin.

Yeni sürüme güncelleyin.

Masaüstü uygulamasını kendi sunucunuza bağlayın.