SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

VPS पर Mealie कैसे इंस्टॉल करें: Docker Compose गाइड

अपने VPS पर Mealie को Docker Compose के साथ सेटअप करना सीखें। यह गाइड आपको रेसिपी इंपोर्ट, मील प्लान, शॉपिंग लिस्ट और Nginx के साथ सुरक्षित TLS कॉन्फ़िगरेशन सेटअप करने में मदद करेगी।

Self-hosted recipe manager क्या करता है

एक self-hosted recipe manager आपकी recipes को आपके अपने सर्वर पर स्थित database में सुरक्षित रखता है, और Mealie वह विकल्प है जिसे अधिकांश घरों में पसंद किया जाता है। आप किसी recipe पेज का address paste करते हैं और Mealie उसमें से सामग्री (ingredients), चरण (steps), मात्रा (yield) और पकाने का समय (cook time) निकाल लेता है, और बाकी की कहानी व विज्ञापनों को हटा देता है। आपके collection में केवल भोजन संबंधी जानकारी ही बचती है।

App का बाकी हिस्सा छोटा है। इसमें एक साप्ताहिक meal plan है जिसमें आप recipes को drag कर सकते हैं, और उस plan से बनी एक shopping list भी है। खाना बनाने वाले प्रत्येक व्यक्ति का अपना login होता है। यह सब एक container में चलता है, और requests के बीच यह idle रहता है, इसलिए एक साधारण VPS इसे बिना किसी भार के चला सकता है।

यह guide Docker Compose का उपयोग करती है। यदि services: और volumes: शब्द आपके लिए नए हैं, तो पहले Docker Compose files कैसे बनाई जाती हैं पढ़ें, क्योंकि नीचे दी गई पूरी प्रक्रिया एक compose file और चार commands पर आधारित है।

Docker Compose के साथ Mealie इंस्टॉल करना

Mealie अपनी images को GitHub container registry पर प्रकाशित करता है। 18 November 2026 तक, वर्तमान stable tag v3.31.0 है, जिसे 13 November को जारी किया गया था। इस release में सुरक्षा सुधार शामिल हैं, और प्रोजेक्ट हर किसी को अपडेट करने की सलाह देता है। latest का उपयोग करने के बजाय एक version को पिन करें: latest के साथ, किसी असंबंधित दिन पर एक docker compose pull आपको ऐसे database migration पर ले जा सकता है जिसके लिए आप तैयार नहीं थे।

sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.yml
services:
  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:

इसे शुरू करने से पहले दो पंक्तियों पर ध्यान देना आवश्यक है।

Port को 127.0.0.1:9925:9000 के रूप में लिखा गया है, न कि 9925:9000 के रूप में। Container अंदर 9000 पर listen करता है, और host उस पर 9925 को map करता है। उस map को loopback address पर bind करने का अर्थ है कि Nginx Mealie तक पहुँच सकता है, लेकिन इंटरनेट नहीं। Docker अपने स्वयं के नियमों को packet filter में लिखता है, इसलिए एक साधारण 9925:9000 बाहर से तब भी पहुँच योग्य होता है जब आपका firewall कहता है कि port बंद है। यह आश्चर्य एक बार समझने लायक है: देखें क्यों प्रकाशित Docker ports ufw को अनदेखा करते हैं।

BASE_URL वह सटीक public address होना चाहिए जिसका आप उपयोग करेंगे, जिसमें scheme हो और अंत में कोई slash न हो। Mealie इससे password reset लिंक और invitation लिंक बनाता है। यदि आप इसे http://localhost:9925 पर सेट करते हैं, तो आपके द्वारा अपने साथी को भेजा गया निमंत्रण एक ऐसा लिंक होगा जो केवल सर्वर पर ही काम करेगा।

इसे शुरू करें और पहली boot प्रक्रिया देखें।

sudo docker compose up -d
sudo docker compose logs -f mealie

पहली शुरुआत SQLite database बनाती है और migrations चलाती है, जिसमें कुछ सेकंड लगते हैं। जब log स्थिर हो जाए और migration पंक्तियों को प्रिंट करना बंद कर दे, तो ऐप को स्थानीय रूप से जाँचें।

curl -I http://127.0.0.1:9925

200 OK का अर्थ है कि ऐप चल रहा है। यदि आपको Connection refused मिलता है, तो container की स्थिति और exit code की जाँच करने के लिए sudo docker compose ps -a चलाएँ। कोड 137 के साथ रुके हुए container को SIGKILL प्राप्त हुआ था; केवल वह कोड यह नहीं दिखाता है कि उसने 1000M memory limit को पार कर लिया है। Container को मैन्युअल रूप से kill करने पर भी वही कोड उत्पन्न होता है।

प्रथम लॉगिन और ओपन साइनअप को बंद करना

डिफ़ॉल्ट अकाउंट changeme@example.com है और इसका पासवर्ड MyPassword है। इससे लॉग इन करें और तुरंत दोनों को बदल दें, क्योंकि यह जोड़ा डॉक्यूमेंटेशन में छपा होता है और इसलिए हर स्कैनर की पहुँच में रहता है।

कंपोज़ फ़ाइल में ALLOW_SIGNUP: "false" जानबूझकर रखा गया है। यदि साइनअप खुला है, तो कोई भी व्यक्ति जिसे आपका पता मिल जाए, वह आपके रेसिपी बॉक्स में अकाउंट बना सकता है। इसे बंद रखने पर, आप एडमिन एरिया से लोगों को जोड़ते हैं, जो एक इनविटेशन लिंक बनाता है जिसे आप स्वयं उन्हें भेजते हैं। वह लिंक BASE_URL से बनता है, इसीलिए यह वैल्यू महत्वपूर्ण है। यदि आप एक ही सर्वर पर कई ऐप्स चला रहे हैं और उन सभी के लिए एक ही पासवर्ड चाहते हैं, तो Mealie अपने लॉगिन को किसी बाहरी आइडेंटिटी प्रोवाइडर जैसे एक self-hosted Authentik instance को सौंप सकता है।

Mealie उपयोगकर्ताओं को एक हाउसहोल्ड (household) में रखता है, और हाउसहोल्ड एक ग्रुप के अंदर होते हैं। एक हाउसहोल्ड के सभी सदस्य मील प्लान और शॉपिंग लिस्ट साझा करते हैं, जो कि एक परिवार की आवश्यकता होती है। रेसिपी कलेक्शन इससे कहीं अधिक व्यापक है: हाउसहोल्ड अपनी रेसिपी, टैग और कैटेगरी को उसी ग्रुप के अन्य सभी हाउसहोल्ड के साथ साझा करते हैं। इसलिए, एक सर्वर पर अलग-अलग हाउसहोल्ड के प्लान और लिस्ट तो अलग रहते हैं, लेकिन वे एक ही रेसिपी से खाना बनाते हैं। यह फ्लैटशेयर (flatshare) के लिए उपयुक्त है जहाँ लोग किसी विशेष सामग्री पर सहमत नहीं होते। यदि लोगों को पूरी तरह से अलग कलेक्शन चाहिए, तो उन्हें अलग ग्रुप दें, क्योंकि ग्रुप्स के बीच कुछ भी साझा नहीं होता है।

इंपोर्टर, जिसे चलाने का मुख्य कारण

रेसिपी कलेक्शन खोलें, URL से रेसिपी बनाने का विकल्प चुनें और लिंक पेस्ट करें। Mealie पेज को फेच करता है और स्ट्रक्चर्ड रेसिपी डेटा की तलाश करता है, जो कि मशीन-रीडेबल ब्लॉक होता है जिसे अधिकांश रेसिपी साइटें सर्च इंजन के लिए एम्बेड करती हैं। जब वह ब्लॉक मौजूद होता है, तो इंपोर्ट साफ और तुरंत हो जाता है।

यदि आप एक AI प्रोवाइडर कॉन्फ़िगर करते हैं, तो आप किसी इमेज या पेस्ट किए गए प्लेन टेक्स्ट से भी इंपोर्ट कर सकते हैं, जो कि कुकबुक के पेज की फोटो के लिए उपयोगी है। इमेज इंपोर्ट के लिए ऐसे प्रोवाइडर की आवश्यकता होती है जो इमेज को पढ़ सके। प्रोवाइडर के बिना ये इंपोर्ट उपलब्ध नहीं होते हैं। ये एक धीमी प्रक्रिया से गुजरते हैं और बाद में जांच की मांग करते हैं, क्योंकि हाथ से लिखे गए फ्रैक्शन (fraction) को गलत पढ़ना आसान होता है।

बल्क इंपोर्ट उसी स्क्रीन से चलते हैं: पतों की एक सूची पेस्ट करें, प्रति लाइन एक, और Mealie बैकग्राउंड में उन पर काम करता है। दो सौ बुकमार्क का कलेक्शन एक ही बार में ट्रांसफर हो जाता है।

Meal plans और shopping list

Meal planner एक calendar है। किसी recipe को drag करके किसी दिन पर रखें, और वह plan हो जाएगी। सामग्री (ingredients) इकट्ठा करने के लिए planned recipes को shopping list में जोड़ें। duplicates को combine करने के लिए, पहले Manage Data के अंतर्गत Foods और Units को seed करें, प्रत्येक recipe पर ingredient amounts को enable करें और इसके ingredients को उन foods और units में parse करें। इससे दो recipes में onions की आवश्यकता होने पर दो लाइनों के बजाय एक ही लाइन दिखाई देगी।

यह list दुकान में आपके phone पर एक live page के रूप में काम करती है। चूँकि यह आपके अपने server पर host होती है, इसलिए घर का हर सदस्य एक ही समय पर एक ही list देख सकता है। यदि एक व्यक्ति milk को tick करके हटाता है, तो वह दूसरे व्यक्ति की screen से भी हट जाता है।

Nginx और TLS को सामने रखें

इस सेटअप में Mealie साधारण HTTP का उपयोग करता है; यह TLS_CERTIFICATE_PATH और TLS_PRIVATE_KEY_PATH के माध्यम से TLS को भी सपोर्ट करता है। इसके सामने nginx में Transport Layer Security (TLS) को terminate करें। सबसे पहले अपने सर्वर पर एक DNS A record पॉइंट करें, क्योंकि सर्टिफिकेट स्टेप उस नाम को सत्यापित करता है।

sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealie
server {
    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 nginx

nginx -t के माध्यम से syntax is ok और test is successful को प्रिंट करना एक गेट की तरह है। केवल इसके पास होने के बाद ही reload करें, क्योंकि खराब कॉन्फ़िगरेशन को reload करने पर पुरानी कॉन्फ़िगरेशन ही चलती रहती है और अगली बार restart होने तक गलती का पता नहीं चलता।

client_max_body_size 64M यहाँ इसलिए है क्योंकि nginx का डिफ़ॉल्ट मान 1 MB है। ब्राउज़र के माध्यम से रेसिपी की फोटो अपलोड करने या बैकअप रिस्टोर करने पर उससे बड़ी फाइल भेजी जाती है, और इस लाइन के बिना आपको nginx से 413 Request Entity Too Large मिलता है, न कि Mealie से, इसलिए एप्लिकेशन लॉग में कुछ भी दिखाई नहीं देता।

इसके बाद सर्टिफिकेट जारी करें। वह स्टेप और उसका रिन्यूअल टाइमर nginx के लिए certbot के साथ Let's Encrypt सर्टिफिकेट जारी करना में कवर किया गया है।

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.com

Certbot सर्वर ब्लॉक को 443 पर listen करने के लिए फिर से लिखता है और पोर्ट 80 से एक रीडायरेक्ट जोड़ता है। साइट को https:// पर लोड करें और पुष्टि करें कि ब्राउज़र सर्टिफिकेट स्वीकार करता है। यदि Mealie लोड हो जाता है लेकिन उसके अपने लिंक आपको http:// पर भेजते हैं, तो इसका मतलब है कि BASE_URL अभी भी http दिखा रहा है और इसे ठीक करने की आवश्यकता है, जिसके बाद नए मान के साथ कंटेनर को फिर से बनाने के लिए sudo docker compose up -d का उपयोग करें।

Mealie को example.com/recipes जैसे सबपाथ के तहत सर्व करना काम नहीं करता है, क्योंकि फ्रंटएंड को सबपाथ से सर्व नहीं किया जा सकता है। एक सबडोमेन का उपयोग करें।

Backups, और एक restore वास्तव में क्या करता है

Mealie का सारा डेटा container के अंदर /app/data/ में रहता है, जो कि mealie-data volume है। उस volume को copy करने का मतलब है कि आपने recipes, images और database को एक साथ copy कर लिया है। Mealie का अपना documentation container को stop करके इस folder को copy करने को ही SQLite install का backup लेने का सबसे अच्छा तरीका बताता है।

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 mealie

Volume के नाम में prefix के तौर पर project का नाम होता है, और project का नाम वह directory है जिसमें compose file रखी होती है। /srv/mealie से volume का नाम mealie_mealie-data है, इसीलिए पहली command docker volume ls है: जो नाम यह print करे उसी का उपयोग करें, इस guide में दिए गए नाम का नहीं। container को पहले stop करना महत्वपूर्ण है, क्योंकि SQLite अक्सर write process के बीच में होता है, जिससे live copy restore करने पर unreadable हो सकती है।

Mealie के admin area में उसका अपना backup page भी है, जो database को database.json के रूप में एक zip archive में लिखता है। एक archive को Mealie के उसी या नए version पर चल रहे instance में restore किया जा सकता है। servers के बीच move करने के लिए, volume को copy करते समय नए box पर वही pinned version चलाएं, या archive को उसी या नए version में restore करें। एक को restore करना अपनी बनावट (design) के कारण विनाशकारी है: यह archive को load करने से पहले वर्तमान database को हटा देता है, और इसे पूर्ववत (undo) नहीं किया जा सकता है। प्रक्रिया पूरी होने पर आप logout हो जाएंगे।

जब तक ये copies उसी server पर रहती हैं, तब तक इनमें से कोई भी backup नहीं है। archive को एक schedule के अनुसार कहीं और भेजें, जिसके लिए encrypted off-server backups with restic का उपयोग किया जाता है।

Mealie को अपडेट करना

cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie

फाइल में पिन किए गए version को बढ़ाएं, फिर pull करें और recreate करें। नए image के पहली बार start होने पर migrations अपने आप चलते हैं। major version change से पहले volume की एक copy बना लें, क्योंकि यदि migration बीच में विफल हो जाता है, तो database ऐसी स्थिति में रह जाता है जिसे पिछला image फिर से नहीं खोल पाएगा। अपने वर्तमान version और नए version के बीच के सभी release notes को ध्यान से पढ़ें।

जब importer विफल हो जाता है

कुछ sites कोई structured recipe data प्रकाशित नहीं करती हैं, और Mealie तब खाली ingredient list के साथ केवल एक title import करता है। बिना AI provider के इसे configure नहीं किया जा सकता, इसलिए recipe text को मैन्युअल रूप से paste करें। यदि provider configured है, तो जब scraper को कुछ नहीं मिलता, तो Mealie page contents को model को भेज देता है, और परिणाम को किसी भी अन्य AI import की तरह मूल सामग्री से जाँचने की आवश्यकता होती है।

अन्य विफलताएँ recipe site के सामने मौजूद bot protection के कारण होती हैं, जो Mealie को recipe के बजाय एक challenge page भेजती है। Mealie पहले से ही एक browser का रूप धारण करता है और इसे कम करने के लिए अपने user agent को rotate करता है। जब कोई site फिर भी मना कर दे, तो documented विकल्प यह है कि scraper को बेहतर address reputation वाले proxy के माध्यम से भेजा जाए, या एक FlareSolverr instance चलाया जाए जो वास्तविक browser में challenge को हल करता है। दोनों वैकल्पिक हैं, और दोनों को container पर environment variables के माध्यम से set किया जाता है।

एक import जो इसलिए विफल होता है क्योंकि आपका server site तक नहीं पहुँच पा रहा है, वह एक अलग समस्या है। scraper को दोष देने से पहले curl -I https://the-site.example/recipe के साथ box से इसका परीक्षण करें और status line पढ़ें। v3.26.0 के बाद से Mealie private या internal addresses से fetch करने से भी मना करता है, इसलिए आपके अपने network पर host किया गया recipe page तब तक import नहीं होगा जब तक आप इसके host को HTTP_ALLOW_LIST environment variable में न जोड़ दें।

यह कहाँ फिट बैठता है

Mealie किसी household के लिए एक अच्छा पहला self-hosted application है, क्योंकि आपके साथ रहने वाले लोग इसे बिना कहे उपयोग करेंगे। इसका काम Immich के साथ अपनी photo library चलाने जैसा ही है, हालांकि यह काफी हल्का है, और यह इस वर्ष self-host करने योग्य चीजों की विस्तृत सूची में शामिल है। एक छोटा server दोनों को चला सकता है। उस दूसरे काम के लिए Immich ही एकमात्र विकल्प नहीं है। यदि आप अभी भी तय कर रहे हैं, तो PhotoPrism और Immich की memory requirements और backup commands में पर्याप्त अंतर है, इसलिए disk की बाकी जगह किसी अन्य काम के लिए देने से पहले उन्हें पढ़ना उपयोगी होगा। यदि household अपने dinners के साथ plans और notes भी कहीं रखना चाहता है, तो self-hosted AFFiNE workspace फिर से वही compose-file exercise है, लेकिन इसके लिए Mealie की तुलना में चार containers और काफी अधिक memory चाहिए। इसलिए पहले देखें कि box में कितने resources बचे हैं। यदि household अपने dinners के साथ training भी track करना चाहता है, तो openGym workouts को संभालता है और उसी pinned tag, compose file और certificate की मांग करता है, जिन पर आपने अभी काम किया है। Dinner के बाद की शाम के लिए इसका एक अलग रूप है, क्योंकि Halcyon मौजूदा Jellyfin library को 1990s की ऐसी rental shop में बदल देता है जिसमें आप घूम सकते हैं। यह किसी पहले से चल रही service के सामने एक और छोटा container जोड़ता है, न कि backup के लिए एक और database। इस समूह की हर चीज household app नहीं है। यदि यही आदत कभी work के लिए भी कुछ संभालने लगे, तो self-hosted Chatwoot support desk फिर से वही pinned tag और certificate इस्तेमाल करता है, लेकिन इसके पीछे Postgres, Redis और काम करने वाला outbound mail चाहिए। यह recipe box की तुलना में काफी भारी tenant है और इसके लिए अपना server होना चाहिए।

FAQ

रेसिपी URL को इम्पोर्ट करना विफल क्यों हो जाता है?

इसके दो सामान्य कारण हैं। या तो पेज कोई संरचित रेसिपी डेटा प्रकाशित नहीं करता है, इसलिए scraper को कुछ नहीं मिलता है और, जब तक कि पेज को पढ़ने के लिए AI provider कॉन्फ़िगर न हो, आपको बिना सामग्री वाला शीर्षक मिलता है, या साइट के सामने एक bot-protection लेयर रेसिपी के बजाय एक challenge पेज लौटाती है। दूसरे मामले के लिए Mealie को बेहतर address reputation वाले proxy, या किसी self-hosted FlareSolverr instance की ओर इंगित किया जा सकता है जो वास्तविक browser में challenge को हल करता है। कुछ भी बदलने से पहले curl -I के साथ पुष्टि करें कि आपका सर्वर पेज तक पहुँच सकता है या नहीं।

क्या मुझे PostgreSQL की आवश्यकता है, या SQLite पर्याप्त है?

SQLite एक घर के लिए पर्याप्त है, और यह डिफ़ॉल्ट है। PostgreSQL पर तब जाएँ जब data directory network attached storage पर हो, क्योंकि network filesystem पर SQLite locked-database त्रुटियाँ उत्पन्न करता है और फ़ाइल को corrupt कर सकता है। PostgreSQL के तहत रिस्टोर के लिए database user को superuser होने की आवश्यकता होती है, क्योंकि रिस्टोर archive लोड करने से पहले सब कुछ हटा देता है।

क्या मैं बिना domain name के Mealie चला सकता हूँ?

हाँ, अपने नेटवर्क पर। BASE_URL को उस पते पर सेट करें जिसे आप वास्तव में टाइप करेंगे, जैसे कि http://192.168.1.20:9925, अपने सर्वर के LAN address का उपयोग करके port mapping को 192.168.1.20:9925:9000 में बदलें, और nginx को छोड़ दें। दोनों परिवर्तनों को लागू करने के लिए sudo docker compose up -d चलाएँ। मूल 127.0.0.1:9925:9000 मैपिंग केवल Docker host से कनेक्शन स्वीकार करती है। निमंत्रण और पासवर्ड रीसेट लिंक BASE_URL से बनाए जाते हैं, इसलिए गलत मान ऐसे लिंक बनाता है जिन्हें कोई और नहीं खोल सकता। इसे सादे HTTP पर इंटरनेट के सामने न लाएँ, क्योंकि लॉगिन तब स्पष्ट रूप से भेजा जाता है।

मैं अपने परिवार को उनके अपने लॉगिन कैसे दूँ?

ALLOW_SIGNUP को "false" पर सेट रहने दें और admin area से लोगों को जोड़ें, जो एक निमंत्रण लिंक बनाता है जिसे आप उन्हें भेजते हैं। रसोई साझा करने वाले सभी लोगों को एक ही household में रखें ताकि वे meal plan और shopping list साझा कर सकें। रेसिपी वैसे भी समूह के हर household के साथ साझा की जाती हैं, इसलिए जिन लोगों को अलग संग्रह की आवश्यकता है, उन्हें अलग समूहों की आवश्यकता है।

यदि मैं Mealie चलाना बंद कर दूँ तो मेरी रेसिपी का क्या होगा?

वे सुरक्षित रहती हैं। Admin बैकअप आपके डेटा को JSON के रूप में लिखता है, और Mealie रेसिपी को JSON फ़ाइलों के रूप में भी export कर सकता है, जो किसी भी सॉफ़्टवेयर के बिना किसी भी text editor में पठनीय रहती हैं। आवश्यकता पड़ने से पहले एक export लें और जाँचें कि आप इसे खोल सकते हैं।

क्या यह लेख उपयोगी था?