Cài Mealie trên VPS bằng Docker Compose
Tự host Mealie trên VPS với Docker Compose: dán link công thức để lấy bước nấu sạch, kèm meal plan, shopping list, nginx, TLS và backup.
Chức năng của một recipe manager tự host
Một recipe manager tự host lưu các công thức nấu ăn trong database trên server do bạn sở hữu. Mealie là lựa chọn mà hầu hết các hộ gia đình dùng. Bạn dán địa chỉ của một trang công thức nấu ăn, Mealie sẽ đọc nguyên liệu, các bước thực hiện, khẩu phần và thời gian nấu từ trang đó, rồi bỏ qua phần câu chuyện và quảng cáo. Thứ được lưu vào bộ sưu tập của bạn là công thức món ăn.
Phần còn lại của app khá gọn. Có một kế hoạch bữa ăn hằng tuần để bạn kéo các công thức vào, cùng một shopping list được tạo từ kế hoạch đó. Mỗi người nấu ăn có một login riêng. Toàn bộ app chạy trong một container và gần như idle giữa các request, nên một VPS cấu hình vừa phải có thể chạy app mà không bị ảnh hưởng đáng kể.
Hướng dẫn này dùng Docker Compose. Nếu các thuật ngữ services: và volumes: còn mới với bạn, trước tiên hãy đọc cách tổ chức file Docker Compose, vì toàn bộ phần bên dưới chỉ gồm một compose file và bốn lệnh.
Cài đặt Mealie bằng Docker Compose
Mealie phát hành các image lên GitHub container registry. Tính đến ngày 18 tháng 11 năm 2026, tag stable hiện tại là v3.31.0, được phát hành vào ngày 13 tháng 11. Bản phát hành này có các bản sửa lỗi bảo mật và dự án khuyến nghị mọi người cập nhật. Hãy pin một phiên bản thay vì dùng latest: với latest, một docker compose pull vào một ngày bất kỳ có thể đưa bạn sang một database migration mà bạn chưa chuẩn bị.
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:Có 2 dòng cần kiểm tra trước khi khởi động.
Port được ghi là 127.0.0.1:9925:9000 chứ không phải 9925:9000. Container listen trên port 9000 ở bên trong, còn host map port 9925 vào port đó. Bind mapping này vào loopback address giúp nginx truy cập được Mealie, còn Internet thì không. Docker tự ghi rule vào packet filter, nên một 9925:9000 thông thường vẫn có thể truy cập từ bên ngoài ngay cả khi firewall của bạn báo port đó đã đóng. Bạn nên hiểu rõ điều bất ngờ này một lần: xem vì sao port Docker đã publish bỏ qua ufw.
BASE_URL phải là public address chính xác mà bạn sẽ dùng, có scheme và không có dấu gạch chéo ở cuối. Mealie dùng địa chỉ này để tạo link reset password và link invitation. Nếu đặt thành http://localhost:9925, invitation bạn gửi cho partner sẽ chứa một link chỉ hoạt động trên chính server đó.
Khởi động ứng dụng và theo dõi lần boot đầu tiên.
sudo docker compose up -d
sudo docker compose logs -f mealieLần khởi động đầu tiên tạo SQLite database và chạy các migration, mất vài giây. Khi log ổn định và không còn in các dòng migration, hãy kiểm tra app locally.
curl -I http://127.0.0.1:9925Một 200 OK nghĩa là app đã hoạt động. Nếu nhận được Connection refused, hãy chạy sudo docker compose ps -a để kiểm tra status và exit code của container. Container dừng với code 137 đã nhận SIGKILL; chỉ riêng code đó không cho biết container đã vượt giới hạn bộ nhớ 1000M. Việc kill container thủ công cũng tạo ra code này.
Đăng nhập lần đầu và tắt đăng ký mở
Tài khoản mặc định là changeme@example.com với mật khẩu MyPassword. Hãy đăng nhập bằng tài khoản này, sau đó đổi cả hai ngay lập tức, vì cặp thông tin này được in trong tài liệu và do đó có trong mọi scanner.
ALLOW_SIGNUP: "false" trong file compose là có chủ đích. Khi đăng ký mở, bất kỳ ai tìm được địa chỉ đều có thể tạo tài khoản trong hộp công thức của bạn. Khi tắt đăng ký, bạn thêm người dùng từ khu vực quản trị; hệ thống sẽ tạo một invitation link để bạn tự gửi cho họ. Link đó được tạo từ BASE_URL, nên giá trị này rất quan trọng. Nếu sau này bạn chạy nhiều app trên cùng một server và muốn dùng một mật khẩu cho tất cả, Mealie có thể chuyển việc đăng nhập sang một identity provider bên ngoài như một instance Authentik tự host.
Mealie đưa người dùng vào một household, còn các household nằm trong một group. Mọi người trong cùng một household dùng chung meal plan và shopping list, phù hợp với nhu cầu của một gia đình. Recipe collection có phạm vi rộng hơn: các household chia sẻ recipe, tag và category với mọi household khác trong cùng group. Vì vậy, các household riêng trên cùng một server vẫn có plan và list riêng, nhưng dùng chung recipe; mô hình này vẫn phù hợp với một flatshare nơi không ai thống nhất được chuyện có cho anchovy hay không. Nếu người dùng cần các collection hoàn toàn riêng biệt, hãy tạo group riêng cho họ, vì không có gì được chia sẻ giữa các group.
Trình importer, cũng là lý do để chạy ứng dụng này
Mở bộ sưu tập công thức, chọn tạo công thức từ URL rồi dán liên kết vào. Mealie sẽ tải trang và tìm dữ liệu công thức có cấu trúc, tức khối dữ liệu mà máy có thể đọc và hầu hết các trang công thức đều nhúng vào để công cụ tìm kiếm sử dụng. Khi có khối dữ liệu này, quá trình import sẽ sạch và hoàn tất ngay.
Nếu cấu hình một AI provider, bạn cũng có thể import từ hình ảnh hoặc văn bản thuần được dán vào. Cách này phù hợp với ảnh chụp một trang trong sách dạy nấu ăn. Image import cần provider có khả năng đọc hình ảnh. Nếu không có provider, các kiểu import này sẽ không khả dụng. Chúng đi qua quy trình chậm hơn và cần được kiểm tra sau đó, vì phân số viết tay rất dễ bị đọc sai.
Bulk import cũng chạy từ cùng màn hình đó: dán danh sách địa chỉ, mỗi địa chỉ một dòng, rồi Mealie sẽ xử lý chúng trong background. Một bộ sưu tập gồm hai trăm bookmark có thể được chuyển sang chỉ trong một lần.
Kế hoạch bữa ăn và danh sách mua sắm
Công cụ lập kế hoạch bữa ăn là một lịch. Kéo một công thức vào một ngày để lập kế hoạch cho công thức đó. Thêm các công thức đã lên kế hoạch vào danh sách mua sắm để tổng hợp nguyên liệu. Để gộp các mục trùng lặp, trước tiên hãy tạo Foods và Units trong Manage Data, bật số lượng nguyên liệu cho từng công thức, rồi phân tích nguyên liệu thành các food và unit tương ứng. Khi đó, nếu hai công thức đều cần hành, danh sách sẽ chỉ có một dòng thay vì hai.
Danh sách là một trang cập nhật theo thời gian thực trên điện thoại của bạn khi đi mua hàng. Vì server của bạn lưu danh sách này, mọi người trong nhà đều thấy cùng một danh sách vào cùng thời điểm. Khi một người đánh dấu sữa đã mua, sữa cũng biến mất khỏi màn hình của người kia.
Đặt nginx và TLS phía trước
Trong thiết lập này, Mealie sử dụng HTTP thuần; ứng dụng cũng hỗ trợ TLS thông qua TLS_CERTIFICATE_PATH và TLS_PRIVATE_KEY_PATH. Hãy terminate TLS tại nginx đặt phía trước Mealie. Trước tiên, trỏ bản ghi DNS A đến server của bạn, vì bước cấp certificate sẽ xác minh tên đó.
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 in ra syntax is ok và test is successful là bước kiểm tra bắt buộc. Chỉ reload sau khi kiểm tra thành công, vì reload cấu hình bị lỗi sẽ giữ cấu hình cũ đang chạy và che mất lỗi cho đến lần restart tiếp theo.
client_max_body_size 64M cần thiết vì giá trị mặc định của nginx là 1 MB. Khi upload ảnh món ăn hoặc restore backup qua trình duyệt, request body sẽ lớn hơn mức đó. Nếu thiếu dòng này, nginx trả về 413 Request Entity Too Large chứ không phải Mealie, nên application log hoàn toàn không ghi nhận gì.
Sau đó cấp certificate. Bước này và renewal timer của nó được hướng dẫn trong cấp certificate Let's Encrypt cho nginx bằng certbot.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot sửa server block để listen trên cổng 443 và thêm redirect từ cổng 80. Mở site qua https:// và xác nhận trình duyệt chấp nhận certificate. Nếu Mealie tải được nhưng các link của ứng dụng lại chuyển bạn đến http://, thì BASE_URL vẫn có giá trị http và cần sửa lại. Sau đó chạy sudo docker compose up -d để tạo lại container với giá trị mới.
Không thể chạy Mealie dưới subpath như example.com/recipes, vì frontend không hỗ trợ phục vụ từ subpath. Hãy dùng subdomain.
Backup và thực tế khi restore
Toàn bộ dữ liệu Mealie quản lý nằm trong /app/data/ bên trong container, tức volume mealie-data. Sao chép volume đó là bạn đã sao chép cả recipe, image và database. Tài liệu của Mealie gọi việc dừng container rồi sao chép thư mục này là cách tốt nhất để backup một cài đặt SQLite.
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 mealieTên volume có tên project làm prefix, còn tên project là tên directory chứa file compose. Từ /srv/mealie, volume là mealie_mealie-data, đó là lý do command đầu tiên là docker volume ls: hãy dùng tên command in ra, không dùng tên trong hướng dẫn này. Cần dừng container trước, vì SQLite thường đang ghi dở; bản sao trực tiếp có thể khôi phục thành file không đọc được.
Mealie cũng có trang backup riêng trong khu vực admin, trang này ghi một zip archive chứa database dưới dạng database.json. Có thể restore archive vào một instance đang chạy cùng phiên bản hoặc phiên bản Mealie mới hơn. Để chuyển sang server khác, hãy chạy cùng pinned version trên server mới khi sao chép volume, hoặc restore archive vào cùng phiên bản hoặc phiên bản mới hơn. Restore archive có tính phá hủy theo thiết kế: nó xóa database hiện tại trước khi nạp archive và không thể hoàn tác. Bạn sẽ bị đăng xuất khi quá trình hoàn tất.
Không bản sao nào là backup nếu vẫn nằm trên cùng server. Hãy định kỳ đẩy archive đến một nơi khác, đó là mục đích của backup mã hóa ngoài server bằng restic.
Cập nhật Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieTăng version đã pin trong file, sau đó pull và tạo lại container. Migration chạy trong lần khởi động đầu tiên của image mới. Hãy sao lưu volume trước khi chuyển sang major version mới, vì migration thất bại giữa chừng có thể để lại database mà image cũ không còn mở được. Đọc release notes cho tất cả các phiên bản nằm giữa version hiện tại và version mới.
Khi importer lỗi
Một số site không publish structured recipe data nào, nên Mealie chỉ import title với ingredient list trống. Nếu không có AI provider thì bạn không thể xử lý việc này bằng cấu hình; hãy paste nội dung recipe vào thủ công. Khi đã cấu hình provider, Mealie chuyển nội dung trang cho model nếu scraper không tìm thấy gì, và kết quả vẫn cần được kiểm tra với bản gốc như mọi AI import khác.
Các lỗi khác đến từ bot protection đặt trước recipe site. Lớp này trả về challenge page cho Mealie thay vì recipe. Mealie đã giả lập browser và xoay vòng user agent để giảm tình trạng này. Nếu site vẫn từ chối, các tùy chọn được tài liệu hóa là đưa scraper qua proxy có address reputation tốt hơn, hoặc chạy một instance FlareSolverr để giải challenge trong browser thật. Cả 2 đều không bắt buộc và đều được cấu hình qua environment variable trên container.
Import thất bại vì server của bạn hoàn toàn không thể truy cập site là một vấn đề khác. Hãy test từ server bằng curl -I https://the-site.example/recipe và đọc status line trước khi đổ lỗi cho scraper. Từ v3.26.0, Mealie cũng từ chối fetch từ private hoặc internal address, nên recipe page host trên network của bạn sẽ không được import cho đến khi bạn thêm host đó vào environment variable HTTP_ALLOW_LIST.
Nó phù hợp ở đâu
Mealie là một ứng dụng self-hosted đầu tiên phù hợp cho hộ gia đình, vì những người sống cùng bạn sẽ tự sử dụng mà không cần nhắc. Công việc này có cùng dạng với việc chạy thư viện ảnh riêng bằng Immich nhưng nhẹ hơn nhiều, đồng thời thuộc danh sách rộng hơn về những thứ đáng self-host trong năm nay. Một server nhỏ có thể chạy cả hai. Immich không phải ứng viên duy nhất cho công việc thứ hai đó. Nếu bạn vẫn đang cân nhắc, mức RAM tối thiểu và các lệnh backup của PhotoPrism và Immich khác nhau đủ nhiều để bạn nên đọc trước khi dùng hết phần dung lượng còn lại. Nếu hộ gia đình cũng lưu kế hoạch và ghi chú bên cạnh các món ăn, workspace AFFiNE self-hosted cũng chỉ là một bài tập compose file tương tự, nhưng cần 4 container và nhiều RAM hơn đáng kể so với Mealie. Vì vậy, trước tiên hãy kiểm tra server còn bao nhiêu tài nguyên. Nếu hộ gia đình muốn theo dõi việc tập luyện bên cạnh các bữa ăn, openGym lưu các buổi tập và cũng yêu cầu tag đã pin, compose file và certificate giống như phần bạn vừa cấu hình. Buổi tối sau bữa ăn cũng có một phiên bản tương tự, vì Halcyon biến thư viện Jellyfin hiện có thành một cửa hàng cho thuê phim thập niên 1990 mà bạn có thể đi quanh, tức là thêm một container nhỏ phía trước thứ bạn đang chạy thay vì thêm một database cần backup. Không phải mọi ứng dụng trong nhóm này đều dành cho hộ gia đình. Nếu sau này cùng thói quen đó cần phục vụ công việc, bàn hỗ trợ Chatwoot self-hosted cũng dùng lại tag đã pin và certificate, nhưng cần Postgres, Redis và outbound mail hoạt động phía sau. Đây là một tenant nặng hơn nhiều so với một ứng dụng lưu công thức nấu ăn và nên có server riêng.
FAQ
Tại sao việc import URL công thức lại thất bại?
Có 2 nguyên nhân phổ biến. Một là trang không cung cấp dữ liệu công thức có cấu trúc, nên scraper không tìm thấy gì và, nếu bạn chưa cấu hình AI provider để đọc trang thay thế, bạn chỉ nhận được tiêu đề mà không có nguyên liệu. Hai là lớp bảo vệ bot phía trước trang trả về trang challenge thay vì công thức. Với trường hợp thứ hai, bạn có thể trỏ Mealie đến một proxy có uy tín địa chỉ tốt hơn hoặc đến một instance FlareSolverr tự host để giải challenge trong trình duyệt thật. Xác nhận server của bạn có thể truy cập trang đó bằng curl -I trước khi thay đổi bất kỳ thứ gì.
Tôi có cần PostgreSQL không, hay SQLite là đủ?
SQLite đủ dùng cho một hộ gia đình và là lựa chọn mặc định. Chuyển sang PostgreSQL khi data directory nằm trên network attached storage, vì SQLite trên network filesystem gây lỗi database bị khóa và có thể làm hỏng file. Khi restore bằng PostgreSQL, database user phải là superuser vì thao tác restore sẽ xóa mọi thứ trước khi nạp archive.
Tôi có thể chạy Mealie mà không cần domain name không?
Có, trong mạng riêng của bạn. Đặt BASE_URL thành địa chỉ bạn sẽ thực sự nhập, chẳng hạn http://192.168.1.20:9925, đổi port mapping thành 192.168.1.20:9925:9000 bằng địa chỉ LAN của server, rồi bỏ qua nginx. Chạy sudo docker compose up -d để áp dụng cả 2 thay đổi. Mapping 127.0.0.1:9925:9000 ban đầu chỉ nhận kết nối từ Docker host. Link invitation và password reset được tạo từ BASE_URL, nên giá trị sai sẽ tạo ra các link mà không ai khác mở được. Không expose nó ra Internet qua HTTP thuần, vì khi đó thông tin đăng nhập sẽ được gửi ở dạng không mã hóa.
Làm thế nào để cấp login riêng cho người thân?
Giữ ALLOW_SIGNUP ở giá trị "false" và thêm người dùng trong khu vực admin. Thao tác này tạo ra một invitation link để bạn gửi cho họ. Đặt mọi người dùng chung một bếp vào cùng household để họ dùng chung meal plan và shopping list. Dù theo cách nào, công thức cũng được chia sẻ với mọi household trong group, nên những người cần collection riêng phải dùng các group riêng.
Công thức của tôi sẽ ra sao nếu tôi ngừng chạy Mealie?
Chúng có thể được lấy ra. Bản backup trong admin ghi dữ liệu của bạn dưới dạng JSON. Mealie cũng có thể export công thức thành các file JSON, và các file này vẫn đọc được bằng mọi text editor mà không cần bất kỳ software nào. Hãy tạo một bản export trước khi cần đến nó và kiểm tra rằng bạn mở được file đó.