Windmill'i VPS'te Kendiniz Barındırma (Eksiksiz Rehber)

Windmill, betikleri webhook’lara, iş akışlarına, cron görevlerine ve dahili arayüzlere dönüştürür - Retool ve Temporal’ın açık kaynaklı alternatifi. Kendiniz barındırmak zor değil, ama başlamadan önce bilinmesi gereken bir püf noktası var: Redis kullanmaz, internetteki birçok rehber aksini söylese de.

Windmill’i Neden Kendiniz Barındırmalısınız?

Bulut planı hem kişi başına hem de çalıştırma başına faturalandırılır. Kendiniz barındırmak iki sayacı da kaldırır ve bu bir otomasyon platformunda önemlidir, çünkü zamanlanmış olarak çalıştırmak isteyeceğiniz işler tam da çalıştırma ücretlerini biriktirecek olanlardır. Ayrıca betiklerinizi, kimlik bilgilerinizi ve iş günlüklerinizi kendi makinenizde tutar; o betikler çalıştırdığınız her şeyin API anahtarlarını taşır.

Topluluk sürümü AGPL-3.0 lisanslıdır. Kurumsal derleme bir lisans anahtarının ve farklı bir imaj etiketinin arkasındadır; platformu çalıştırmak için ona ihtiyacınız yok.

Doğru VPS’i Seçmek

Windmill uygulamaya göre değil işçiye göre boyutlandırılır. Pratik kural, vCPU başına bir işçi ve her birine 1-2 GB RAM, üstüne Postgres ile sunucu sürecinin payıdır.

İş hacmi işçi sayısıyla ölçeklendiği için burada çekirdek sayısı saat hızından önemlidir. Ayrıntılı karşılaştırma için tam VPS karşılaştırmamıza bakın.

Ön Koşullar

• En az 2 vCPU ve 4 GB RAM’e sahip, Ubuntu 24.04 LTS çalıştıran bir VPS
• Docker Engine ve Compose v2
• TLS istiyorsanız sunucuya yönlendirilmiş bir alan adı

Adım 1: VPS’i Hazırlayın

Bağlanın ve güncelleyin:

ssh root@sunucu-ip-adresiniz
apt update && apt upgrade -y

Docker’ı ve Compose eklentisini kurun:

apt install -y docker.io docker-compose-v2
systemctl enable --now docker
docker compose version

Caddy’nin kullanacağı portları açın:

ufw allow OpenSSH && ufw allow 80 && ufw allow 443
ufw enable

Adım 2: Resmî Compose Yığınını İndirin

Windmill için elle compose dosyası yazmayın. Proje kendi dosyasını yayımlar ve işçileri, indeksleyiciyi ve dil sunucularını doğru biçimde birbirine bağlar:

mkdir -p ~/windmill && cd ~/windmill
curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/windmill-labs/windmill/main/docker-compose.yml
curl -fsSL -o .env https://raw.githubusercontent.com/windmill-labs/windmill/main/.env
curl -fsSL -o Caddyfile https://raw.githubusercontent.com/windmill-labs/windmill/main/Caddyfile

İndirdiğiniz yığın yedi servis çalıştırır:

• db - postgres:16, hem veritabanı hem de iş kuyruğu
• windmill_server - 8000 portunda API ve web arayüzü
• windmill_worker - işleri yürütür
• windmill_worker_native - hafif işler, yaklaşık 0.1 CPU ve 128 MB
• windmill_indexer - iş geçmişinde tam metin arama
• windmill_extra - tarayıcı içi düzenleyiciyi besleyen dil sunucuları
• caddy - 80 portunda ters proxy

Bu listede Redis yok ve sizinkinde de olmamalı.

Adım 3: Parolanızı ve Alan Adınızı Ayarlayın

Yayımlanan .env bilinçli olarak zayıf bir varsayılan içerir:

DATABASE_URL=postgres://postgres:changeme@db/windmill?sslmode=disable
WM_IMAGE=ghcr.io/windmill-labs/windmill:main

Veritabanı ilk açılışta oluşturulduğu için changeme değerini o açılıştan önce üretilmiş bir sırla değiştirin:

openssl rand -hex 24

Aynı dosyada BASE_URL değerini alan adınıza ayarlayın. Caddy sertifika istemek için onu okur.

Adım 4: Başlatın

docker compose up -d
docker compose ps

İlk açılış birkaç imaj çeker ve veritabanı göçlerini uygular, bu yüzden ona bir dakika tanıyın. Alan adınızı açıp ilk hesabı oluşturun - o hesap örneğin süper yöneticisi olur.

Adım 5: İhtiyaç Duydukça İşçi Ekleyin

Windmill’i çoğu self-hosting uygulamasından ayıran kısım burası. Tek bir süreci büyüterek değil, işçi konteyneri ekleyerek ölçeklenirsiniz. docker-compose.yml içindeki windmill_worker bloğunu kopyalayın, yeni bir servis adı verin, aynı DATABASE_URL ve MODE=worker değerlerini koruyun, sonra uygulayın:

docker compose up -d

İşçiler Postgres üzerinden koordine olur, başka bir yapılandırma değişmez. Her biri için kabaca bir vCPU ve 1-2 GB RAM ayırın.

Adım 6: Veritabanını Yedekleyin

Önemli olan her şey - betikler, akışlar, zamanlamalar, kaynaklar, iş geçmişi - Postgres’te durur. Bağımlılık önbelleği birimi türetilmiş veridir ve kendini yeniden oluşturur.

docker compose exec db pg_dump -U postgres windmill | gzip > windmill-$(date +%F).sql.gz

Dosyayı sunucudan dışarı kopyalayın. Windmill diğer sistemlerinizin kimlik bilgilerini sakladığı için o dökümü bir sır olarak görün ve şifreli saklayın.

İnsanların Takıldığı Yerler

Bir blogdan Redis’li compose dosyası kopyalamak. Windmill’in ona hiç ihtiyacı olmadı. Konteyner açılır ve boş boş bekler, siz de kuyruğun onu neden kullanmadığını merak edersiniz.

Durağan hâle göre boyutlandırmak. Bellek zirvesi bağımlılık kurulumunda yaşanır. pandas içe aktaran bir Python işi ilk çalıştırmada sonrakilerin çok üstünde RAM ister, yani boştayken sorunsuz görünen bir yığın soğuk bir işte çökebilir.

changeme değerini olduğu gibi bırakmak. Bu, yayımlanan .env dosyasındaki Postgres parolasıdır ve 5432 portunu bir gün dışarı açarsanız fırsatçı bir taramanın ilk deneyeceği şeydir.

Windmill, hızlı çekirdekten çok sayıda çekirdeği ödüllendirir; ucuz Avrupa çok çekirdekli planlarını onun için alışılmadık biçimde iyi bir seçenek yapan da budur. Aynı anda kaç iş çalıştırmak istediğinize göre boyutlandırın, Postgres dökümünü şifreli bir yerde tutun; gerisi rahat yaşanan bir servistir.

Daha fazla self-hosting projesi ve ipucu için awesome-selfhosted listesine veya r/selfhosted topluluğuna göz atın.