VPS Uzerinde Docker ile Mealie Yemek Tarifi Yoneticisi
Docker Compose kullanarak kendi VPS sunucunuzda Mealie kurulumunu yapin. Tarif linklerini otomatik ayiklayin, alisveris listeleri olusturun ve Nginx ile TLS destegi saglayin.
Self-hosted bir yemek tarifi yöneticisi ne işe yarar
Self-hosted bir yemek tarifi yöneticisi, tariflerinizi kendi sunucunuzdaki bir veritabanında tutar; Mealie, çoğu hanenin tercih ettiği bu alandaki en popüler çözümdür. Bir yemek tarifi sayfasının adresini yapıştırdığınızda Mealie; malzemeleri, hazırlık adımlarını, porsiyon miktarını ve pişirme süresini ayrıştırır; hikaye kısımlarını ve reklamları ayıklar. Koleksiyonunuza yalnızca yemek tarifi eklenir.
Uygulamanın geri kalan özellikleri oldukça sadedir. Tariflerinizi sürükleyip bırakabileceğiniz haftalık bir yemek planlayıcı ve bu plandan otomatik olarak oluşturulan bir alışveriş listesi bulunur. Yemek yapan her kullanıcı için ayrı bir oturum açma hesabı tanımlanabilir. Tüm sistem tek bir container içerisinde çalışır ve istek gelmediği sürece boşta bekler; bu nedenle mütevazı bir VPS üzerinde kaynak tüketimi hissedilmeyecek kadar azdır.
Bu rehber Docker Compose kullanmaktadır. Eğer services: ve volumes: terimleri size yabancıysa, öncelikle Docker Compose dosyalarının yapısı hakkındaki bölümü okuyun; çünkü aşağıda yer alan tüm yapı tek bir compose dosyası ve dört komuttan oluşmaktadır.
Docker Compose ile Mealie Kurulumu
Mealie, imajlarını GitHub container kayıt defterinde yayınlar. 18 Kasım 2026 itibarıyla güncel kararlı etiket v3.31.0 olup 13 Kasım tarihinde yayınlanmıştır. Bu sürüm güvenlik düzeltmeleri içerir ve proje, herkesin güncelleme yapmasını önerir. latest kullanmak yerine bir sürümü sabitleyin: latest ile, alakasız bir günde gerçekleşen bir docker compose pull, sizi hazır olmadığınız bir veritabanı geçişine zorlayabilir.
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.31.0
container_name: mealie
restart: always
ports:
- "127.0.0.1:9925:9000"
deploy:
resources:
limits:
memory: 1000M
volumes:
- mealie-data:/app/data/
environment:
ALLOW_SIGNUP: "false"
PUID: 1000
PGID: 1000
TZ: Europe/Amsterdam
BASE_URL: https://recipes.example.com
volumes:
mealie-data:Başlatmadan önce iki satıra dikkat edilmelidir.
Port, 9925:9000 olarak değil 127.0.0.1:9925:9000 olarak yazılmıştır. Container içeride 9000 portunu dinler ve ana makine 9925 portunu buna yönlendirir. Bu eşlemeyi loopback adresine bağlamak, Nginx'in Mealie'ye erişebileceği ancak internetin erişemeyeceği anlamına gelir. Docker kendi kurallarını paket filtresine yazar, bu nedenle güvenlik duvarınız portun kapalı olduğunu söylese bile düz bir 9925:9000 dışarıdan erişilebilir durumdadır. Bu sürprizin bir kez anlaşılması faydalıdır: bkz. yayınlanan Docker portları neden ufw'yi görmezden gelir.
BASE_URL, şema ile birlikte ve sonunda eğik çizgi olmadan kullanacağınız tam genel adres olmalıdır. Mealie, parola sıfırlama ve davet bağlantılarını bu adresten oluşturur. Bunu http://localhost:9925 olarak ayarlarsanız, partnerinize gönderdiğiniz davet yalnızca sunucunun kendisinde çalışan bir bağlantı içerecektir.
Başlatın ve ilk açılışı izleyin.
sudo docker compose up -d
sudo docker compose logs -f mealieİlk başlatma SQLite veritabanını oluşturur ve geçişleri çalıştırır; bu işlem birkaç saniye sürer. Günlük kayıtları durulduğunda ve geçiş satırlarını yazdırmayı bıraktığında, uygulamayı yerel olarak kontrol edin.
curl -I http://127.0.0.1:9925200 OK, uygulamanın çalıştığı anlamına gelir. Connection refused alırsanız, container'ın durumunu ve çıkış kodunu kontrol etmek için sudo docker compose ps -a komutunu çalıştırın. 137 koduyla duran bir container SIGKILL almıştır; bu kod tek başına 1000M bellek sınırını aştığını göstermez. Container'ı manuel olarak sonlandırmak da bu kodu üretir.
İlk giriş ve açık kayıt özelliğinin kapatılması
Varsayılan hesap changeme@example.com, parola ise MyPassword şeklindedir. Bu bilgilerle giriş yapın ve her ikisini de derhal değiştirin; çünkü bu ikili dokümantasyonda yer aldığından tüm güvenlik tarayıcılarının hedefindedir.
Compose dosyasındaki ALLOW_SIGNUP: "false" ayarı bilinçli olarak bu şekilde bırakılmıştır. Kayıt özelliği açık olduğunda, adresi bulan herkes tarif kutunuzda bir hesap oluşturabilir. Özellik kapatıldığında ise kullanıcıları yönetim panelinden eklersiniz; bu işlem, kişiye bizzat ileteceğiniz bir davet bağlantısı oluşturur. Söz konusu bağlantı BASE_URL değerinden türetildiği için bu değer önemlidir. Aynı sunucuda birden fazla uygulama çalıştırıyorsanız ve hepsinde tek bir parola kullanmak istiyorsanız, Mealie giriş işlemlerini kendi barındırdığınız bir Authentik örneği gibi harici bir kimlik sağlayıcısına devredebilir.
Mealie, kullanıcıları bir hane halkına (household), hane halklarını ise bir gruba dahil eder. Bir hane halkındaki herkes yemek planını ve alışveriş listesini paylaşır; bu da ailelerin ihtiyaç duyduğu yapıdır. Tarif koleksiyonu ise daha geniştir: Hane halkları, tariflerini, etiketlerini ve kategorilerini aynı gruptaki diğer tüm hane halklarıyla paylaşır. Bu nedenle, aynı sunucudaki farklı hane halkları kendi planlarını ve listelerini ayrı tutarken aynı tarifleri kullanabilir; bu durum, hamsi konusunda anlaşamayan ev arkadaşları için dahi uygun bir yöntemdir. Eğer kullanıcıların tamamen ayrı koleksiyonlara ihtiyacı varsa, onları farklı gruplara atayın; çünkü gruplar arasında hiçbir veri paylaşılmaz.
İçe aktarıcı, çalıştırmanın temel nedeni
Tarif koleksiyonunu açın, bir URL'den tarif oluşturmayı seçin ve bir bağlantı yapıştırın. Mealie sayfayı getirir ve çoğu tarif sitesinin arama motorları için gömdüğü makine tarafından okunabilir blok olan yapılandırılmış tarif verisini arar. Bu blok mevcut olduğunda içe aktarma temiz ve anında gerçekleşir.
Bir yapay zeka sağlayıcısı yapılandırırsanız, bir görselden veya yapıştırdığınız düz metinden de içe aktarma yapabilirsiniz; bu, bir yemek kitabındaki sayfanın fotoğrafını da kapsar. Görsel içe aktarma, görselleri okuyabilen bir sağlayıcı gerektirir. Bir sağlayıcı olmadan bu içe aktarma yöntemleri kullanılamaz. Bu yöntemler daha yavaş bir yoldan ilerler ve sonrasında kontrol edilmeleri gerekir, çünkü el yazısı bir kesri yanlış okumak kolaydır.
Toplu içe aktarmalar aynı ekrandan çalıştırılır: her satıra bir tane gelecek şekilde adres listesini yapıştırın; Mealie bunları arka planda işler. İki yüz yer iminden oluşan bir koleksiyon tek seferde aktarılabilir.
Yemek planları ve alışveriş listesi
Yemek planlayıcı bir takvimdir. Bir tarifi günün üzerine sürüklediğinizde planlanmış olur. Malzemeleri toplamak için planlanan tarifleri bir alışveriş listesine ekleyin. Yinelenen öğeleri birleştirmek için önce Manage Data altındaki Foods ve Units bölümlerini yapılandırın, her tarifte malzeme miktarlarını etkinleştirin ve malzemeleri bu yiyecek ve birimlere göre ayrıştırın; böylece soğan gerektiren iki tarif, iki satır yerine tek bir satır oluşturur.
Liste, markette telefonunuzda görüntülenen canlı bir sayfadır. Kendi sunucunuzda barındırıldığı için evdeki herkes aynı listeyi aynı anda görür ve bir kişi sütü işaretlediğinde, bu öğe diğer kişinin ekranından da kaldırılır.
Nginx ve TLS yapılandırmasını öne alın
Mealie bu kurulumda düz HTTP üzerinden çalışır; ayrıca TLS_CERTIFICATE_PATH ve TLS_PRIVATE_KEY_PATH aracılığıyla TLS desteği de sunar. Taşıma katmanı güvenliğini (TLS) Mealie'nin önündeki nginx üzerinde sonlandırın. Sertifika adımı alan adını doğruladığı için önce sunucunuza bir DNS A kaydı yönlendirin.
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
listen 80;
server_name recipes.example.com;
client_max_body_size 64M;
location / {
proxy_pass http://127.0.0.1:9925;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginxnginx -t ile syntax is ok ve test is successful yazdırmak bir kontrol mekanizmasıdır. Yalnızca test başarılı olduktan sonra yeniden yükleme yapın; çünkü hatalı bir yapılandırmayı yeniden yüklemek, eski yapılandırmanın çalışmaya devam etmesine ve hatanın bir sonraki yeniden başlatmaya kadar gizli kalmasına neden olur.
client_max_body_size 64M satırı, nginx varsayılan değeri 1 MB olduğu için eklenmiştir. Tarayıcı üzerinden bir yemek tarifi fotoğrafı yüklemek veya yedek geri yüklemek bu değerden daha büyük bir gövde gönderir; bu satır olmadan nginx üzerinden 413 Request Entity Too Large hatası alırsınız. Hata Mealie'den değil nginx'ten kaynaklandığı için uygulama günlüklerinde hiçbir kayıt görünmez.
Ardından sertifikayı oluşturun. Bu adım ve sertifika yenileme zamanlayıcısı certbot ile nginx için Let's Encrypt sertifikası oluşturma bölümünde ele alınmıştır.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot, sunucu bloğunu 443 numaralı portu dinleyecek şekilde yeniden yazar ve 80 numaralı porttan yönlendirme ekler. Siteyi https:// üzerinden yükleyin ve tarayıcının sertifikayı kabul ettiğini doğrulayın. Mealie yükleniyor ancak kendi bağlantıları sizi http:// adresine yönlendiriyorsa, BASE_URL hala http değerini içeriyor demektir. Bu değerin düzeltilmesi ve ardından konteynerin yeni değerle yeniden oluşturulması için sudo docker compose up -d komutu kullanılmalıdır.
Mealie'yi example.com/recipes gibi bir alt dizin altında sunmak çalışmaz, çünkü arayüz bir alt dizinden sunulamaz. Bir alt alan adı (subdomain) kullanın.
Yedeklemeler ve geri yüklemenin gerçekte yaptığı işlem
Mealie'ye ait her şey, mealie-data volume'ü olan container içindeki /app/data/ dizininde yaşar. Bu volume'ü kopyaladığınızda tarifleri, görselleri ve veritabanını birlikte kopyalamış olursunuz. Mealie'nin kendi belgeleri, container'ı durdurup bu klasörü kopyalamayı bir SQLite kurulumunu yedeklemenin en iyi yolu olarak tanımlar.
sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealieVolume adı, proje adını bir önek olarak taşır ve proje adı, compose dosyasını tutan dizindir. /srv/mealie dizininden volume mealie_mealie-data'dir, bu nedenle ilk komut docker volume ls'dir: bu kılavuzdaki adı değil, yazdırdığı adı kullanın. Önce container'ı durdurmak önemlidir, çünkü SQLite sık sık yazma işlemi halindedir ve canlı bir kopyanın geri yüklenmesi okunamaz sonuçlar doğurabilir.
Mealie'nin ayrıca yönetici alanında, veritabanını database.json olarak yazan kendi yedekleme sayfası vardır. Bir arşiv, Mealie'nin aynı veya daha yeni bir sürümünü çalıştıran bir örneğe geri yüklenebilir. Sunucular arasında geçiş yapmak için, volume'ü kopyalarken yeni makinede aynı sabitlenmiş sürümü çalıştırın veya arşivi aynı ya da daha yeni bir sürüme geri yükleyin. Birini geri yüklemek tasarım gereği yıkıcıdır: arşivi yüklemeden önce mevcut veritabanını siler ve bu işlem geri alınamaz. İşlem bittiğinde oturumunuz kapatılır.
Her iki kopya da aynı sunucuda durduğu sürece yedek sayılmaz. Arşivi düzenli olarak başka bir yere gönderin; restic ile şifreli sunucu dışı yedeklemeler bunun içindir.
Mealie Güncelleme
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieDosya içerisindeki sabitlenmiş sürümü yükseltin, ardından imajı çekip konteyneri yeniden oluşturun. Veritabanı geçişleri (migrations), yeni imajın ilk başlatılması sırasında otomatik olarak çalıştırılır. Büyük bir sürüm değişikliği öncesinde mutlaka birim (volume) yedeği alın; çünkü yarıda kalan bir geçiş işlemi, veritabanını önceki imajın artık açamayacağı bir duruma getirebilir. Mevcut sürümünüz ile yeni sürüm arasındaki tüm sürümlere ait sürüm notlarını (release notes) mutlaka okuyun.
İçe aktarma başarısız olduğunda
Bazı siteler hiçbir yapılandırılmış tarif verisi yayınlamaz; bu durumda Mealie, boş bir malzeme listesiyle yalnızca başlığı içe aktarır. Bir yapay zeka sağlayıcısı yapılandırılmadığı sürece bu durum yapılandırma ile çözülemez; bu nedenle tarif metnini manuel olarak yapıştırmanız gerekir. Bir sağlayıcı yapılandırıldığında, kazıyıcı (scraper) hiçbir şey bulamadığında Mealie sayfa içeriğini modele iletir; sonuç, diğer tüm yapay zeka içe aktarmalarında olduğu gibi orijinaliyle karşılaştırılarak kontrol edilmelidir.
Diğer başarısızlıklar, tarif sitesinin önündeki bot korumasından kaynaklanır; bu koruma, Mealie'ye tarif yerine bir doğrulama sayfası (challenge page) ile yanıt verir. Mealie, bunu azaltmak için halihazırda bir tarayıcıyı taklit eder ve user agent bilgisini değiştirir. Bir site yine de erişimi reddederse, belgelenen seçenekler kazıyıcıyı daha iyi bir adres itibarına sahip bir proxy üzerinden yönlendirmek veya doğrulama işlemini gerçek bir tarayıcıda çözen bir FlareSolverr örneği çalıştırmaktır. Her iki seçenek de isteğe bağlıdır ve container üzerindeki ortam değişkenleri (environment variables) aracılığıyla ayarlanır.
Sunucunuzun siteye hiçbir şekilde ulaşamaması nedeniyle başarısız olan bir içe aktarma işlemi farklı bir sorundur. Kazıyıcıyı suçlamadan önce sunucu üzerinden curl -I https://the-site.example/recipe ile test edin ve durum satırını okuyun. v3.26.0 sürümünden itibaren Mealie, özel veya dahili adreslerden veri çekmeyi reddeder; bu nedenle kendi ağınızda barındırılan bir tarif sayfası, ana bilgisayarını HTTP_ALLOW_LIST ortam değişkenine ekleyene kadar içe aktarılmayacaktır.
Nerede konumlanır
Mealie, ev halkının kendiliğinden kullanacağı bir uygulama olduğu için ev ortamında self-host edilecek ilk uygulamalardan biridir. Bu, kendi fotoğraf kütüphanenizi Immich ile yönetmek ile benzer bir iş yüküne sahiptir ancak çok daha hafiftir ve bu yıl self-host etmeye değer şeyler listesinde yer alır. Tek bir küçük sunucu her ikisini de barındırabilir. Immich bu ikinci görev için tek aday değildir; hala karar aşamasındaysanız, PhotoPrism ve Immich'in bellek gereksinimleri ile yedekleme komutları arasındaki farklar, diskin geri kalanını ayırmadan önce okunmaya değerdir. Eğer ev halkı yemek planlarının yanı sıra notlarını da bir yerde tutmak isterse, self-hosted bir AFFiNE çalışma alanı yine aynı compose-file egzersizidir; ancak dört container gerektirir ve Mealie'den çok daha fazla bellek ister, bu yüzden önce sunucuda ne kadar kaynak kaldığını kontrol edin. Eğer ev halkı yemeklerin yanı sıra antrenmanlarını da takip etmek isterse, openGym antrenmanları kaydeder ve az önce üzerinde çalıştığınız sabit etiket, compose dosyası ve sertifika ile aynı gereksinimleri sunar. Akşam yemeğinden sonraki zaman dilimi için de benzer seçenekler mevcuttur; Halcyon, mevcut bir Jellyfin kütüphanesini içinde gezinebileceğiniz 1990'lardan kalma bir video kiralama dükkanına dönüştürür. Bu, yedeklenmesi gereken başka bir veritabanı yerine, halihazırda çalıştırdığınız bir servisin önünde duran küçük bir container'dır. Bu ailenin her parçası bir ev uygulaması değildir; eğer aynı alışkanlık iş için de bir şeyler barındırmanızı gerektirirse, self-hosted bir Chatwoot destek masası yine aynı sabit etiket ve sertifikayı kullanır ancak arkasında Postgres, Redis ve çalışan bir giden posta sunucusu gerektirir. Bu, bir yemek tarifleri kutusundan çok daha ağır bir yüktür ve kendi sunucusunu hak eder.
FAQ
Bir tarif URL'sini içe aktarma neden başarısız oluyor?
İki yaygın neden vardır. Ya sayfa yapılandırılmış bir tarif verisi yayınlamıyordur, bu yüzden kazıyıcı hiçbir şey bulamaz ve sayfa yerine bir yapay zeka sağlayıcısı yapılandırılmadığı sürece içeriksiz bir başlık alırsınız; ya da sitenin önündeki bir bot koruma katmanı tarif yerine bir doğrulama sayfası döndürüyordur. İkinci durum için Mealie, daha iyi bir adres itibarına sahip bir proxy'ye veya zorluğu gerçek bir tarayıcıda çözen kendi kendine barındırılan bir FlareSolverr örneğine yönlendirilebilir. Herhangi bir şeyi değiştirmeden önce curl -I ile sunucunuzun sayfaya erişebildiğini doğrulayın.
PostgreSQL'e ihtiyacım var mı, yoksa SQLite yeterli mi?
SQLite bir hane halkı için yeterlidir ve varsayılan seçenektir. Veri dizini ağa bağlı depolama (NAS) üzerinde olduğunda PostgreSQL'e geçin, çünkü ağ dosya sistemi üzerinden SQLite kilitli veritabanı hataları üretir ve dosyayı bozabilir. PostgreSQL altındaki geri yüklemeler, geri yükleme işlemi yüklemeden önce her şeyi sildiği için veritabanı kullanıcısının süper kullanıcı olmasını gerektirir.
Mealie'yi alan adı olmadan çalıştırabilir miyim?
Evet, kendi ağınızda. BASE_URL değerini, sunucunuzun LAN adresini kullanarak http://192.168.1.20:9925 gibi gerçekten yazacağınız adrese ayarlayın, port eşlemesini 192.168.1.20:9925:9000 olarak değiştirin ve Nginx'i atlayın. Her iki değişikliği uygulamak için sudo docker compose up -d komutunu çalıştırın. Orijinal 127.0.0.1:9925:9000 eşlemesi yalnızca Docker ana makinesinden gelen bağlantıları kabul eder. Davet ve parola sıfırlama bağlantıları BASE_URL değerinden oluşturulur, bu nedenle yanlış bir değer kimsenin açamayacağı bağlantılar üretir. Giriş bilgileri açık metin olarak gönderileceğinden, bunu düz HTTP üzerinden internete açmayın.
Aileme nasıl kendi giriş bilgilerini verebilirim?
ALLOW_SIGNUP değerini "false" olarak bırakın ve yönetici alanından kişileri ekleyin; bu işlem onlara göndereceğiniz bir davet bağlantısı oluşturur. Mutfağı paylaşan herkesi aynı hane halkına dahil edin, böylece yemek planını ve alışveriş listesini paylaşabilirler. Tarifler her iki durumda da gruptaki her hane ile paylaşılır, bu nedenle ayrı koleksiyonlara ihtiyaç duyan kişilerin ayrı gruplara ihtiyacı vardır.
Mealie'yi çalıştırmayı bırakırsam tariflerime ne olur?
Dışarı çıkarlar. Yönetici yedeklemesi verilerinizi JSON olarak yazar ve Mealie ayrıca tarifleri, herhangi bir yazılım olmadan herhangi bir metin düzenleyicide okunabilir kalan JSON dosyaları olarak dışa aktarabilir. İhtiyacınız olmadan önce bir dışa aktarma alın ve açabildiğinizi kontrol edin.