VPSにMealieを構築する方法 Docker Compose入門
Docker ComposeでVPSにMealieを構築します。レシピURLから材料と手順を取得し、献立、買い物リスト、nginx、TLS、バックアップまで設定できます。
自宅運用のレシピ管理アプリの役割
自宅運用のレシピ管理アプリは、自分で管理するサーバー上のデータベースにレシピを保存します。多くの家庭では Mealie が選ばれています。レシピページの URL を貼り付けると、Mealie はそこから材料、手順、出来上がり量、調理時間を読み取ります。記事本文や広告は取り込みません。コレクションに保存されるのは料理の情報です。
アプリの機能はシンプルです。レシピをドラッグして登録できる週間献立があり、その献立を基に買い物リストを作成できます。料理をする人ごとにログインを用意できます。すべてが 1 つのコンテナで動作し、リクエストがない間はほぼ待機状態になるため、小規模な VPS でも負荷を意識せず運用できます。
このガイドでは Docker Compose を使用します。services: と volumes: が初めての場合は、まず Docker Compose ファイルの構成方法 を読んでください。以下の内容は、1 つの compose ファイルと 4 つのコマンドだけで構成されています。
Docker Compose で Mealie をインストールする
Mealie はイメージを GitHub container registry に公開しています。2026年11月18日時点の最新の安定版タグは v3.31.0 で、11月13日にリリースされました。このリリースにはセキュリティ修正が含まれているため、プロジェクトは全員に更新を推奨しています。latest を使用せず、バージョンを固定してください。latest の場合、関係のない日に docker compose pull が発生すると、準備していなかったデータベースマイグレーションをまたいで更新される可能性があります。
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:起動する前に、2つの行を確認してください。
ポートは 127.0.0.1:9925:9000 と記述されており、9925:9000 ではありません。コンテナ内部では 9000 番ポートで待ち受け、ホストの 9925 番ポートから転送します。このマッピングをループバックアドレスにバインドすると、nginx からは Mealie に接続できますが、インターネットからは接続できません。Docker はパケットフィルターに独自のルールを書き込むため、ファイアウォールでポートを閉じていても、通常の 9925:9000 は外部から到達可能です。この挙動は一度理解しておく価値があります。Docker の公開ポートが ufw を無視する理由を参照してください。
BASE_URL には、実際に使用する正確な公開アドレスを、スキーム付き、末尾のスラッシュなしで指定してください。Mealie はこの値からパスワードリセットリンクと招待リンクを生成します。http://localhost:9925 に設定すると、パートナーに送る招待には、サーバー自体でしか機能しないリンクが含まれます。
起動して、初回起動時のログを監視します。
sudo docker compose up -d
sudo docker compose logs -f mealie初回起動では SQLite データベースを作成し、マイグレーションを実行するため、数秒かかります。ログが落ち着き、マイグレーションの行が出力されなくなったら、ローカルでアプリを確認します。
curl -I http://127.0.0.1:9925200 OK であれば、アプリは起動しています。Connection refused になった場合は、sudo docker compose ps -a を実行してコンテナの状態と終了コードを確認します。コード 137 で停止したコンテナは SIGKILL を受け取っています。ただし、このコードだけでは 1000M のメモリ制限を超えたことは分かりません。コンテナを手動で停止した場合にも、このコードが生成されます。
初回ログインと公開サインアップの無効化
デフォルトのアカウントは changeme@example.com、パスワードは MyPassword です。これでログインしたら、すぐに両方を変更してください。この組み合わせはドキュメントに記載されているため、すべてのスキャナーに知られています。
compose ファイルの ALLOW_SIGNUP: "false" は意図的な設定です。サインアップを公開すると、アドレスを見つけた誰でもレシピボックスにアカウントを作成できます。無効にすると、管理画面からユーザーを追加し、生成された招待リンクを自分で送信します。このリンクは BASE_URL から生成されるため、この値が重要になります。同じサーバー上で複数のアプリを運用し、すべてで1つのパスワードを使いたい場合は、自前でホストした Authentik インスタンスなどの外部 identity provider にログイン処理を委任できます。
Mealie では、ユーザーを household に所属させ、household を group に所属させます。同じ household に所属する全員が meal plan と shopping list を共有します。これは家族での利用に適しています。レシピコレクションの共有範囲はそれより広く、household は同じ group 内のすべての household とレシピ、タグ、カテゴリーを共有します。そのため、同じサーバー上の別々の household は meal plan と shopping list を分けながら、同じレシピを使えます。アンチョビの好みが一致しないシェアハウスにも適した構成です。完全に分離したコレクションが必要な場合は、別々の group を割り当ててください。group 間で共有されるものはありません。
インポーターを実行する理由
レシピコレクションを開き、URL からレシピを作成する操作を選んで、リンクを貼り付けます。Mealie はページを取得し、構造化レシピデータを探します。これは、多くのレシピサイトが検索エンジン向けに埋め込んでいる、機械で読み取れるデータブロックです。このブロックがあれば、インポートはすぐに正しく完了します。
AI provider を設定すると、画像や貼り付けたプレーンテキストからもインポートできます。料理本のページを撮影した画像にも対応できます。画像のインポートには、画像を読み取れる provider が必要です。provider がない場合、これらのインポートは利用できません。処理には時間がかかり、後で確認する必要があります。手書きの分数は読み間違えやすいためです。
一括インポートも同じ画面から実行できます。アドレスの一覧を1行に1件ずつ貼り付けると、Mealie がバックグラウンドで順に処理します。200件のブックマークも、1回の操作で移行できます。
献立と買い物リスト
献立プランナーはカレンダーです。レシピを日にドラッグすると、その日に予定として追加されます。予定したレシピを買い物リストに追加すると、必要な食材をまとめられます。重複を統合するには、まず Manage Data で Foods と Units を登録します。次に各レシピで食材の分量を有効にし、食材をそれらの食品と単位に解析します。これにより、2 つのレシピで onions が必要な場合も、2 行ではなく 1 行にまとめられます。
買い物中は、スマートフォンでリストをリアルタイムに表示できます。リストは自分のサーバーで管理されるため、家族全員が同じリストを同時に確認できます。1 人が milk をチェックすると、他の人の画面からもその項目が削除されます。
nginx と TLS を前段に置く
この構成では、Mealie は通常の HTTP で通信します。TLS_CERTIFICATE_PATH と TLS_PRIVATE_KEY_PATH を使って TLS にも対応できます。Mealie の前段に nginx を置き、TLS を nginx で終端します。まず DNS の A レコードをサーバーに向けてください。証明書の取得時に、その名前が検証されるためです。
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 を実行して syntax is ok と test is successful を出力することが通過条件です。検証に成功してから reload してください。壊れた設定を reload すると、古い設定のまま動作し続けるため、次回の再起動まで誤りが分からなくなります。
nginx のデフォルト値は 1 MB なので、client_max_body_size 64M を設定しています。レシピの写真をアップロードしたり、ブラウザーからバックアップを復元したりすると、この上限を超えるリクエストボディが送信されます。この行がない場合、Mealie ではなく nginx が 413 Request Entity Too Large を返すため、アプリケーションログには何も記録されません。
続いて証明書を発行します。この手順と更新タイマーについては、certbot で nginx 用の Let's Encrypt 証明書を発行するで説明しています。
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot は server block を書き換え、443 番ポートで待ち受ける設定を追加します。また、80 番ポートからのリダイレクトも追加します。https:// でサイトにアクセスし、ブラウザーが証明書を受け入れることを確認してください。Mealie は表示されるものの、内部リンクが http:// に移動する場合は、BASE_URL がまだ http になっています。これを修正した後、sudo docker compose up -d を実行して新しい値でコンテナを再作成します。
example.com/recipes のようなサブパスで Mealie を提供することはできません。フロントエンドがサブパスから配信される構成に対応していないためです。サブドメインを使用してください。
バックアップと、実際のリストアの動作
Mealie が管理するすべてのデータは、コンテナ内の /app/data/ に保存されています。これは mealie-data ボリュームです。このボリュームをコピーすれば、レシピ、画像、データベースをまとめてコピーできます。Mealie の公式ドキュメントでは、コンテナを停止してこのフォルダーをコピーする方法を、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 mealieボリューム名にはプロジェクト名がプレフィックスとして含まれます。プロジェクト名は compose ファイルを格納しているディレクトリ名です。/srv/mealie ではボリュームは mealie_mealie-data になるため、最初のコマンドは docker volume ls です。このガイドに記載された名前ではなく、コマンドが出力する名前を使用してください。SQLite は書き込み途中になることが多いため、コンテナを先に停止することが重要です。稼働中のコピーからは、読み取れない状態でリストアされる可能性があります。
Mealie には管理画面内に独自のバックアップページもあり、データベースを database.json として格納した zip アーカイブを書き出します。アーカイブは、同じバージョンまたはそれ以降のバージョンの Mealie で稼働しているインスタンスにリストアできます。サーバー間で移行する場合は、ボリュームをコピーするときに移行先で同じ固定バージョンを実行するか、同じバージョンまたはそれ以降のバージョンにアーカイブをリストアしてください。リストアは意図的に破壊的な操作です。アーカイブを読み込む前に現在のデータベースを削除するため、元に戻せません。完了するとログアウトされます。
同じサーバー上に置かれている間は、どちらのコピーもバックアップではありません。アーカイブを定期的に別の場所へ送信してください。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ファイル内の固定バージョンを引き上げてから、イメージを pull してコンテナを再作成します。新しいイメージで最初に起動するときに、マイグレーションが実行されます。メジャーバージョンを変更する前に、ボリュームのコピーを作成してください。マイグレーションが途中で失敗すると、以前のイメージでは開けなくなるデータベースが残るためです。現在のバージョンから新しいバージョンまでのすべてのリリースノートを確認してください。
インポーターが失敗する場合
構造化されたレシピデータをまったく公開していないサイトもあります。その場合、Mealie はタイトルだけをインポートし、材料リストは空になります。AI プロバイダーがなければ設定で解決できないため、代わりにレシピ本文を手動で貼り付けてください。プロバイダーを設定すると、スクレーパーが何も見つけられなかったときに Mealie はページ内容をモデルへ渡します。ただし、結果は他の AI インポートと同じように元のページと照合してください。
レシピサイトの前段にある bot protection が原因で失敗することもあります。サイトがレシピではなくチャレンジページを Mealie に返すためです。Mealie はすでにブラウザーを偽装し、これを減らすために user agent をローテーションします。それでもサイトが拒否する場合、公式に記載されている選択肢は、アドレスの評判がより良いプロキシ経由でスクレーパーを実行するか、実際のブラウザーでチャレンジを解決する FlareSolverr インスタンスを実行することです。どちらも任意で、コンテナの環境変数で設定します。
サーバーからサイトへまったく接続できないことが原因のインポート失敗は、別の問題です。スクレーパーを疑う前に、curl -I https://the-site.example/recipe を使ってサーバーからテストし、status 行を確認してください。v3.26.0 以降の Mealie は、プライベートアドレスや内部アドレスへの取得も拒否します。そのため、自分のネットワーク上でホストしているレシピページは、ホストを HTTP_ALLOW_LIST 環境変数に追加するまでインポートできません。
適用範囲
Mealie は、家庭向けの最初のセルフホストアプリとして適しています。同居する人に頼まなくても使ってもらえるからです。これは Immich で自分の写真ライブラリを運用することと同じ種類の用途ですが、はるかに軽量です。また、今年セルフホストする価値があるものの一覧にも含まれます。小規模なサーバー1台で両方を運用できます。2つ目の用途に使える候補は Immich だけではありません。まだ選定中であれば、PhotoPrism と Immich のメモリ要件とバックアップコマンドには読む価値があります。ディスクの残りを使い切る前に、両者の違いを確認してください。家庭で夕食だけでなく予定やメモも管理するなら、セルフホスト型 AFFiNE ワークスペースも同じ compose ファイルを使う構成になります。ただし、必要なコンテナは4つで、Mealie よりもはるかに多くのメモリを要求します。まずサーバーに残っているリソースを確認してください。家庭で夕食だけでなくトレーニングも記録するなら、openGym でワークアウトを管理する構成も利用できます。直前に設定したものと同じ pinned tag、compose ファイル、証明書を使用します。夕食後の時間には、別の用途もあります。Halcyon は既存の Jellyfin ライブラリを歩き回れる1990年代のレンタルショップとして再構成します。これは、すでに運用しているサービスの前段に追加する小規模なコンテナであり、バックアップ対象となる別のデータベースではありません。この分野にあるものがすべて家庭向けアプリとは限りません。同じ運用方法を仕事にも使う必要が生じた場合は、セルフホスト型 Chatwoot サポートデスクを利用できます。これも同じ pinned tag と証明書を使いますが、背後で Postgres、Redis、動作する外向きメールを必要とします。レシピ管理よりもはるかに重いテナントなので、専用サーバーを用意する価値があります。
FAQ
レシピ URL のインポートに失敗するのはなぜですか?
主な原因は2つあります。ページが構造化されたレシピデータを公開していないためスクレーパーが何も見つけられず、代わりにページを読み取る AI プロバイダーも設定されていない場合、材料のないタイトルだけが取得されます。もう1つは、サイトの前段にあるボット対策機能がレシピではなくチャレンジページを返している場合です。後者では、Mealie を、アドレスの評判がより良いプロキシ、または実際のブラウザーでチャレンジを解決する自己ホスト型の FlareSolverr インスタンスに接続できます。変更する前に、curl -I でサーバーからページに到達できることを確認してください。
PostgreSQL は必要ですか。それとも SQLite で十分ですか?
家庭で使用する場合は SQLite で十分であり、デフォルトでもあります。データディレクトリがネットワーク接続ストレージ上にある場合は PostgreSQL に移行してください。SQLite をネットワークファイルシステム上で使用すると、データベースのロックエラーが発生し、ファイルが破損する可能性があります。PostgreSQL でリストアする場合、アーカイブを読み込む前にすべてを削除するため、データベースユーザーはスーパーユーザーである必要があります。
ドメイン名なしで Mealie を実行できますか?
自分のネットワーク内であれば可能です。BASE_URL には、実際に入力するアドレスを設定します。たとえば http://192.168.1.20:9925 です。ポートマッピングをサーバーの LAN アドレスを使用する 192.168.1.20:9925:9000 に変更し、nginx は省略してください。sudo docker compose up -d を実行して、両方の変更を適用します。元の 127.0.0.1:9925:9000 マッピングは、Docker ホストからの接続だけを受け付けます。招待リンクとパスワードリセットリンクは BASE_URL から生成されるため、値が間違っていると、他の人が開けないリンクになります。ログイン情報が平文で送信されるため、通常の HTTP でインターネットに公開しないでください。
家族にそれぞれのログインを与えるにはどうすればよいですか?
ALLOW_SIGNUP を "false" のままにして、管理画面からユーザーを追加してください。招待リンクが生成されるので、各ユーザーに送信します。同じキッチンを共有する全員を同じ household に追加すると、食事計画と買い物リストを共有できます。どちらの場合も、グループ内のすべての household とレシピが共有されます。そのため、別々のコレクションが必要なユーザーには、別々のグループを用意してください。
Mealie の運用を停止すると、レシピはどうなりますか?
取り出せます。管理画面のバックアップ機能はデータを JSON として書き出します。Mealie ではレシピを JSON ファイルとしてエクスポートすることもでき、ソフトウェアがなくてもテキストエディターで読み取れます。必要になる前に一度エクスポートし、開けることを確認してください。