SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Mealie na własnym VPS: instalacja przez Docker Compose

Instrukcja uruchomienia menedżera przepisów Mealie na serwerze VPS przy użyciu Docker Compose. Konfiguracja obejmuje automatyczne pobieranie danych, listy zakupów oraz TLS.

Funkcje własnego menedżera przepisów

Własny menedżer przepisów przechowuje dane w bazie na posiadanym serwerze, a Mealie jest rozwiązaniem najczęściej wybieranym w gospodarstwach domowych. Po wklejeniu adresu strony z przepisem, Mealie odczytuje składniki, instrukcje, liczbę porcji oraz czas przygotowania, pomijając opisy i reklamy. W kolekcji zapisywane są wyłącznie informacje o potrawie.

Pozostałe funkcje aplikacji są ograniczone. Dostępny jest tygodniowy plan posiłków, do którego przeciąga się przepisy, oraz lista zakupów generowana na podstawie tego planu. Każdy użytkownik otrzymuje własne dane logowania. Całość działa w jednym kontenerze i pozostaje w stanie spoczynku między żądaniami, dzięki czemu nawet skromny VPS obsługuje aplikację bez zauważalnego obciążenia.

Niniejszy przewodnik wykorzystuje Docker Compose. Jeśli pojęcia services: oraz volumes: są nieznane, należy najpierw zapoznać się z budową plików Docker Compose, ponieważ poniższa konfiguracja składa się z jednego pliku compose oraz czterech poleceń.

Instalacja Mealie przy użyciu Docker Compose

Mealie publikuje swoje obrazy w rejestrze kontenerów GitHub. Na dzień 18 listopada 2026 r. aktualna stabilna wersja to v3.31.0, wydana 13 listopada. To wydanie zawiera poprawki bezpieczeństwa, a projekt zaleca wszystkim aktualizację. Należy przypiąć wersję zamiast używać latest: przy latest, docker compose pull w nieoczekiwanym dniu może wymusić migrację bazy danych, na którą użytkownik nie jest przygotowany.

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:

Dwie linie wymagają uwagi przed uruchomieniem.

Port zapisano jako 127.0.0.1:9925:9000, a nie 9925:9000. Kontener nasłuchuje wewnętrznie na 9000, a host mapuje na niego 9925. Powiązanie tego mapowania z adresem loopback oznacza, że nginx może połączyć się z Mealie, a Internet nie. Docker zapisuje własne reguły w filtrze pakietów, więc zwykły 9925:9000 jest osiągalny z zewnątrz, nawet jeśli firewall zgłasza port jako zamknięty. Warto raz zrozumieć to zjawisko: zobacz dlaczego opublikowane porty Docker ignorują ufw.

BASE_URL musi być dokładnym adresem publicznym, który będzie używany, wraz ze schematem i bez ukośnika na końcu. Mealie buduje na jego podstawie linki do resetowania hasła i zaproszenia. Ustawienie go na http://localhost:9925 spowoduje, że zaproszenie wysłane do partnera będzie zawierać link działający tylko na samym serwerze.

Uruchom usługę i obserwuj pierwsze uruchomienie.

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

Pierwsze uruchomienie tworzy bazę danych SQLite i wykonuje migracje, co zajmuje kilka sekund. Gdy logi się ustabilizują i przestaną wyświetlać linie migracji, sprawdź aplikację lokalnie.

curl -I http://127.0.0.1:9925

Kod 200 OK oznacza, że aplikacja działa. Jeśli otrzymasz Connection refused, uruchom sudo docker compose ps -a, aby sprawdzić status kontenera i kod wyjścia. Kontener, który zatrzymał się z kodem 137, otrzymał SIGKILL; sam ten kod nie wskazuje, że przekroczono limit pamięci 1000M. Ręczne zabicie kontenera również generuje ten kod.

Pierwsze logowanie i wyłączenie otwartej rejestracji

Domyślne konto to changeme@example.com z hasłem MyPassword. Zaloguj się przy jego użyciu, a następnie natychmiast zmień oba te parametry, ponieważ ta para jest podana w dokumentacji i znajduje się w bazie każdego skanera.

Ustawienie ALLOW_SIGNUP: "false" w pliku compose jest celowe. Przy otwartej rejestracji każda osoba, która znajdzie adres, może utworzyć konto w Twoim zbiorze przepisów. Gdy rejestracja jest wyłączona, dodajesz użytkowników z poziomu panelu administratora, co generuje link zaproszenia, który przesyłasz samodzielnie. Link ten jest tworzony na podstawie BASE_URL, dlatego ta wartość jest istotna. Jeśli uruchamiasz kilka aplikacji na tym samym serwerze i chcesz używać jednego hasła do wszystkich, Mealie może przekazać proces logowania do zewnętrznego dostawcy tożsamości, takiego jak samodzielnie hostowana instancja Authentik.

Mealie przypisuje użytkowników do gospodarstwa domowego, a gospodarstwa domowe znajdują się wewnątrz grupy. Wszyscy członkowie jednego gospodarstwa domowego współdzielą plan posiłków i listę zakupów, co jest rozwiązaniem pożądanym w rodzinie. Kolekcja przepisów jest szersza: gospodarstwa domowe współdzielą swoje przepisy, tagi i kategorie z każdym innym gospodarstwem domowym w tej samej grupie. Oddzielne gospodarstwa domowe na jednym serwerze zachowują zatem osobne plany i listy, ale korzystają z tych samych przepisów, co sprawdza się w mieszkaniu studenckim, gdzie domownicy nie zgadzają się co do dodatku anchois. Jeśli użytkownicy potrzebują całkowicie odseparowanych kolekcji, należy przypisać ich do osobnych grup, ponieważ między grupami nie są współdzielone żadne dane.

Importer, czyli powód uruchomienia aplikacji

Otwórz kolekcję przepisów, wybierz opcję tworzenia przepisu z adresu URL i wklej link. Mealie pobiera stronę i wyszukuje ustrukturyzowane dane przepisu, czyli blok czytelny dla maszyn, który większość stron kulinarnych osadza na potrzeby wyszukiwarek. Jeśli ten blok jest obecny, import przebiega czysto i natychmiastowo.

Jeśli skonfigurujesz dostawcę AI, możesz również importować przepisy z obrazu lub wklejonego tekstu, co pozwala na obsługę zdjęć stron z książek kucharskich. Import obrazów wymaga dostawcy zdolnego do ich odczytu. Bez skonfigurowanego dostawcy te metody importu są niedostępne. Przetwarzanie odbywa się wolniejszą ścieżką i wymaga późniejszej weryfikacji, ponieważ odręcznie zapisane ułamki są łatwe do błędnego odczytania.

Import masowy uruchamia się z tego samego ekranu: wklej listę adresów, po jednym w każdej linii, a Mealie przetworzy je w tle. Kolekcja dwustu zakładek może zostać przeniesiona w jednej sesji.

Plany posiłków i lista zakupów

Planer posiłków to kalendarz. Przeciągnij przepis na wybrany dzień, aby go zaplanować. Dodaj zaplanowane przepisy do listy zakupów, aby zebrać potrzebne składniki. Aby połączyć duplikaty, najpierw zdefiniuj produkty (Foods) i jednostki (Units) w sekcji Zarządzanie danymi (Manage Data), włącz obsługę ilości składników w każdym przepisie i przypisz składniki do tych produktów i jednostek. Dzięki temu dwa przepisy wymagające cebuli wygenerują jedną pozycję zamiast dwóch.

Lista jest stroną działającą w czasie rzeczywistym na telefonie podczas zakupów. Ponieważ jest przechowywana na własnym serwerze, wszyscy domownicy widzą tę samą listę w tym samym czasie, a zaznaczenie mleka przez jedną osobę powoduje jego usunięcie z ekranu pozostałych użytkowników.

Wdrożenie nginx i TLS

W tej konfiguracji Mealie korzysta ze zwykłego HTTP; obsługuje również TLS za pośrednictwem TLS_CERTIFICATE_PATH oraz TLS_PRIVATE_KEY_PATH. Terminację TLS (Transport Layer Security) należy przeprowadzić w nginx przed aplikacją. Najpierw skieruj rekord DNS A na swój serwer, ponieważ proces certyfikacji weryfikuje tę nazwę.

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 drukujący syntax is ok oraz test is successful stanowi bramkę. Przeładuj konfigurację dopiero po pomyślnej weryfikacji, ponieważ przeładowanie błędnej konfiguracji pozostawia działającą starą wersję i ukrywa błąd aż do następnego restartu.

client_max_body_size 64M znajduje się w konfiguracji, ponieważ domyślna wartość w nginx wynosi 1 MB. Przesyłanie zdjęcia przepisu lub przywracanie kopii zapasowej przez przeglądarkę wysyła większy pakiet danych, a bez tej linii otrzymasz 413 Request Entity Too Large z nginx, a nie z Mealie, przez co dziennik aplikacji nie wykaże żadnego błędu.

Następnie wystaw certyfikat. Ten krok oraz harmonogram jego odnawiania zostały opisane w wydawanie certyfikatu Let's Encrypt dla nginx przy użyciu certbot.

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

Certbot nadpisuje blok serwera, aby nasłuchiwał na porcie 443 i dodaje przekierowanie z portu 80. Załaduj stronę przez https:// i potwierdź, że przeglądarka akceptuje certyfikat. Jeśli Mealie się ładuje, ale własne linki kierują na http://, oznacza to, że BASE_URL nadal zawiera http i wymaga poprawy, po której należy wykonać sudo docker compose up -d, aby odtworzyć kontener z nową wartością.

Uruchomienie Mealie w podkatalogu, takim jak example.com/recipes, nie działa, ponieważ frontend nie może być serwowany z podkatalogu. Użyj subdomeny.

Kopie zapasowe i działanie przywracania

Wszystkie dane Mealie znajdują się w /app/data/ wewnątrz kontenera, co stanowi wolumen mealie-data. Skopiowanie tego wolumenu oznacza skopiowanie przepisów, obrazów i bazy danych jednocześnie. Dokumentacja Mealie wskazuje zatrzymanie kontenera i skopiowanie tego folderu jako najlepszą metodę tworzenia kopii zapasowej instalacji 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

Nazwa wolumenu zawiera nazwę projektu jako prefiks, a nazwą projektu jest katalog zawierający plik compose. Z /srv/mealie wolumen to mealie_mealie-data, dlatego pierwszym poleceniem jest docker volume ls: użyj nazwy, która zostanie wyświetlona, a nie nazwy z tego przewodnika. Zatrzymanie kontenera jest istotne, ponieważ SQLite często wykonuje zapisy, przez co kopia działającej bazy może być niemożliwa do odczytania.

Mealie posiada również własną stronę kopii zapasowych w panelu administratora, która zapisuje archiwum zip zawierające bazę danych jako database.json. Archiwum można przywrócić do instancji z tą samą lub nowszą wersją Mealie. Aby przenieść dane między serwerami, uruchom tę samą przypiętą wersję na nowej maszynie podczas kopiowania wolumenu lub przywróć archiwum do tej samej lub nowszej wersji. Przywracanie jest z założenia destrukcyjne: usuwa bieżącą bazę danych przed załadowaniem archiwum i operacji tej nie można cofnąć. Po zakończeniu następuje wylogowanie.

Żadna kopia nie jest kopią zapasową, jeśli znajduje się na tym samym serwerze. Przesyłaj archiwum w inne miejsce zgodnie z harmonogramem, do czego służy szyfrowane kopie zapasowe poza serwerem przy użyciu restic.

Aktualizacja Mealie

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

Zwiększ przypisaną wersję w pliku, a następnie pobierz obraz i odtwórz kontener. Migracje uruchamiają się przy pierwszym starcie nowego obrazu. Przed zmianą wersji głównej wykonaj kopię zapasową wolumenu, ponieważ nieudana migracja może pozostawić bazę danych w stanie nieobsługiwanym przez poprzednią wersję obrazu. Zapoznaj się z informacjami o wydaniu dla wszystkich wersji pomiędzy obecnie używaną a docelową.

Gdy importer zawodzi

Niektóre witryny nie publikują żadnych ustrukturyzowanych danych o przepisach, przez co Mealie importuje jedynie tytuł z pustą listą składników. Bez skonfigurowanego dostawcy AI nie da się tego zmienić, więc wklej tekst przepisu ręcznie. Po skonfigurowaniu dostawcy, gdy scraper nic nie znajdzie, Mealie przekaże zawartość strony do modelu, a wynik wymaga takiej samej weryfikacji z oryginałem, jak każdy inny import AI.

Inne błędy wynikają z ochrony przed botami na stronie z przepisami, która zamiast przepisu zwraca stronę z wyzwaniem (challenge). Mealie już teraz podszywa się pod przeglądarkę i rotuje User-Agent, aby to ograniczyć. Gdy strona nadal odmawia dostępu, udokumentowane opcje to skierowanie scrapera przez proxy o lepszej reputacji adresu lub uruchomienie instancji FlareSolverr, która rozwiązuje wyzwanie w prawdziwej przeglądarce. Obie opcje są opcjonalne i ustawia się je za pomocą zmiennych środowiskowych kontenera.

Import, który kończy się niepowodzeniem, ponieważ serwer w ogóle nie może połączyć się ze stroną, to inny problem. Przetestuj połączenie z poziomu serwera za pomocą curl -I https://the-site.example/recipe i odczytaj linię statusu, zanim obwinisz scrapera. Od wersji v3.26.0 Mealie odmawia również pobierania danych z adresów prywatnych lub wewnętrznych, więc strona z przepisem hostowana w Twojej sieci nie zaimportuje się, dopóki nie dodasz jej hosta do zmiennej środowiskowej HTTP_ALLOW_LIST.

Miejsce w infrastrukturze

Mealie to dobra pierwsza aplikacja do samodzielnego hostowania w gospodarstwie domowym, ponieważ domownicy będą z niej korzystać bez dodatkowej zachęty. Jest to zadanie o podobnym charakterze co prowadzenie własnej biblioteki zdjęć za pomocą Immich, choć znacznie mniej obciążające. Aplikacja ta wpisuje się w szerszą listę rzeczy, które warto hostować samodzielnie w tym roku. Jeden niewielki serwer wystarczy do obsługi obu tych rozwiązań. Immich nie jest jedynym kandydatem do tego drugiego zadania, a jeśli decyzja jeszcze nie zapadła, minimalne wymagania pamięciowe oraz polecenia kopii zapasowych dla PhotoPrism i Immich różnią się na tyle, że warto się z nimi zapoznać przed zajęciem pozostałej części dysku. Jeśli domownicy przechowują w jednym miejscu nie tylko plany posiłków, ale także notatki, samodzielnie hostowana przestrzeń robocza AFFiNE stanowi powtórzenie tego samego ćwiczenia z plikiem Compose. Wymaga ona jednak czterech kontenerów i znacznie większej ilości pamięci niż Mealie, więc najpierw należy sprawdzić dostępne zasoby serwera. Jeśli domownicy chcą śledzić swoje treningi obok planów posiłków, openGym przechowuje dane o ćwiczeniach i wymaga tego samego przypiętego tagu, pliku Compose oraz certyfikatu, które zostały już skonfigurowane. Wieczory po kolacji mają własną propozycję, ponieważ Halcyon przekształca istniejącą bibliotekę Jellyfin w wirtualną wypożyczalnię kaset z lat 90.. Jest to kolejny niewielki kontener działający przed już uruchomioną usługą, a nie kolejna baza danych wymagająca kopii zapasowej. Nie wszystko w tej rodzinie rozwiązań to aplikacje domowe. Jeśli ten sam nawyk miałby zostać wykorzystany w pracy, samodzielnie hostowane biuro obsługi klienta Chatwoot wymaga tego samego przypiętego tagu i certyfikatu, ale dodatkowo opiera się na Postgres, Redis oraz działającej poczcie wychodzącej. Jest to znacznie cięższy komponent niż książka kucharska i zasługuje na własny serwer.

FAQ

Dlaczego importowanie adresu URL przepisu kończy się niepowodzeniem?

Istnieją dwie częste przyczyny. Albo strona nie publikuje ustrukturyzowanych danych przepisu, więc scraper nic nie znajduje i – o ile nie skonfigurowano dostawcy AI do odczytu strony – otrzymasz tytuł bez składników, albo warstwa ochrony przed botami przed stroną zwraca stronę wyzwania zamiast przepisu. W drugim przypadku Mealie można skierować na proxy z lepszą reputacją adresu lub na samodzielnie hostowaną instancję FlareSolverr, która rozwiązuje wyzwanie w prawdziwej przeglądarce. Przed zmianą czegokolwiek potwierdź, że serwer w ogóle może połączyć się ze stroną za pomocą curl -I.

Czy potrzebuję PostgreSQL, czy SQLite wystarczy?

SQLite wystarcza dla gospodarstwa domowego i jest ustawieniem domyślnym. Przejdź na PostgreSQL, gdy katalog danych znajduje się na sieciowej pamięci masowej (NAS), ponieważ SQLite przez system plików sieciowych powoduje błędy blokowania bazy danych i może uszkodzić plik. Przywracanie w PostgreSQL wymaga, aby użytkownik bazy danych był superużytkownikiem, ponieważ przywracanie usuwa wszystko przed załadowaniem archiwum.

Czy mogę uruchomić Mealie bez nazwy domeny?

Tak, we własnej sieci. Ustaw BASE_URL na adres, który faktycznie wpiszesz, na przykład http://192.168.1.20:9925, zmień mapowanie portów na 192.168.1.20:9925:9000, używając adresu LAN serwera, i pomiń nginx. Uruchom sudo docker compose up -d, aby zastosować obie zmiany. Oryginalne mapowanie 127.0.0.1:9925:9000 akceptuje połączenia tylko z hosta Docker. Linki do zaproszeń i resetowania hasła są budowane na podstawie BASE_URL, więc błędna wartość spowoduje wygenerowanie linków, których nikt inny nie będzie mógł otworzyć. Nie wystawiaj usługi do Internetu przez zwykłe HTTP, ponieważ dane logowania są wtedy przesyłane otwartym tekstem.

Jak nadać rodzinie własne loginy?

Pozostaw ALLOW_SIGNUP ustawione na "false" i dodaj osoby z panelu administratora, co wygeneruje link zaproszenia do wysłania. Umieść wszystkich współdzielących kuchnię w tym samym gospodarstwie domowym, aby współdzielili plan posiłków i listę zakupów. Przepisy są współdzielone z każdym gospodarstwem domowym w grupie, więc osoby potrzebujące oddzielnych kolekcji muszą mieć oddzielne grupy.

Co stanie się z moimi przepisami, jeśli przestanę używać Mealie?

Dane można wyeksportować. Kopia zapasowa administratora zapisuje dane w formacie JSON, a Mealie może również eksportować przepisy jako pliki JSON, które pozostają czytelne w dowolnym edytorze tekstu bez żadnego dodatkowego oprogramowania. Wykonaj eksport przed zakończeniem użytkowania i sprawdź, czy plik można otworzyć.

Czy ten artykuł był przydatny?