Language: pl

Mealie: własna książka kucharska, planer posiłków i lista zakupów na VPS-ie

Jeden przepis jest zapisany w zakładkach, drugi w wiadomości, trzeci na zrzucie ekranu, a czwartego trzeba ponownie szukać na stronie pełnej reklam i długiego wstępu. Mealie zbiera wszystko w jednym miejscu: wklejasz link i otrzymujesz kartę przepisu ze składnikami, instrukcją oraz zdjęciem. Następnie możesz dodać danie do kalendarza i przenieść składniki na wspólną listę zakupów.

Poniżej sprawdzimy, co potrafi Mealie, komu się przyda, jakiego serwera potrzebuje oraz jak uruchomić własnego menedżera przepisów na VPS-ie z Docker Compose.

Czym jest Mealie?

Mealie to bezpłatna aplikacja self-hosted do przechowywania przepisów, planowania posiłków i zarządzania listami zakupów. Usługa działa na własnym serwerze, więc samodzielnie decydujesz, gdzie przechowywana jest baza danych, kto ma dostęp i jak powstają kopie zapasowe.

Interfejs otwiera się w przeglądarce na komputerze lub telefonie. Przepisy można tworzyć ręcznie, importować ze stron internetowych, porządkować w kategorie i książki kucharskie, dodawać do tygodniowego menu oraz udostępniać członkom rodziny.

Główna różnica między Mealie a folderem z notatkami polega na tym, że wszystkie elementy są połączone. Przepis można dodać do planu posiłków, powiązać z listą zakupów, filtrować po tagach i wykorzystywać w automatyzacjach przez API.

Najważniejsze funkcje Mealie

Import przepisu z pojedynczego linku

Użytkownik wkleja URL, a Mealie próbuje odczytać nazwę dania, liczbę porcji, składniki, kroki i zdjęcie. Zamiast kolejnej zakładki otrzymujesz przejrzystą kartę przepisu, którą można edytować i zapisać.

Funkcja jest szczególnie przydatna na stronach, gdzie przepis otaczają reklamy i zbędny tekst. Jeśli strona korzysta z niestandardowej struktury, niektóre dane mogą wymagać ręcznej korekty.

Mealie potrafi również przenosić kolekcje z Paprika, Tandoor, Nextcloud Cookbooks i kilku innych menedżerów przepisów. Nie musisz zaczynać z pustą biblioteką.

Import ze zdjęcia, tekstu lub filmu

Opcjonalna integracja AI może utworzyć przepis z tekstu, fotografii strony książki kucharskiej lub linku do filmu. W przypadku filmów usługa pobiera transkrypcję, a następnie wyodrębnia składniki i kolejność czynności.

Ta funkcja wymaga zgodnego dostawcy AI. Możesz podłączyć zewnętrzne API albo własną usługę zgodną z OpenAI, taką jak Ollama. Przed jej włączeniem uwzględnij koszt żądań oraz zasady przetwarzania danych wybranego dostawcy.

Planer posiłków i lista zakupów

Dania są układane według dnia i rodzaju posiłku. Możesz dodać przepis, notatkę taką jak „resztki z wczoraj” albo losowe danie wybrane według reguły — na przykład tylko szybkie kolacje w piątki.

Składniki z przepisów trafiają na listę zakupów. Elementy można odhaczać z telefonu i grupować według działu sklepu. Dzięki temu Mealie staje się nie tylko archiwum, lecz także praktycznym narzędziem na cały tydzień.

Dostęp rodzinny i automatyzacje

Mealie obsługuje użytkowników, grupy i gospodarstwa domowe. Rodzina może korzystać ze wspólnej kolekcji przepisów, zachowując w razie potrzeby osobne plany posiłków i listy zakupów.

REST API, powiadomienia i webhooki pozwalają łączyć usługę z innymi systemami. Oficjalna integracja z Home Assistant może na przykład wyświetlać nadchodzące posiłki w kalendarzu i współpracować z listą zakupów.

Dla kogo jest Mealie?

Mealie przyda się, gdy przepisy są rozproszone po stronach internetowych, notatkach i zdjęciach, menu trzeba za każdym razem układać od początku, kilka osób korzysta z tej samej listy zakupów, ważna jest kontrola nad własną bazą danych albo potrzebujesz automatyzacji.

Usługa może być przesadą, jeśli masz tylko kilka stałych dań i nie chcesz utrzymywać Dockera. Self-hosting uniezależnia od cudzego konta w chmurze, ale serwer nadal trzeba aktualizować, zabezpieczać i tworzyć jego kopie zapasowe.

Jakiego serwera potrzebuje Mealie?

W oficjalnej konfiguracji Docker Compose kontener ma limit 1000 MB pamięci. Mała instalacja może działać na 1 vCPU i 1 GB RAM-u, ale VPS z 2 GB zapewnia zapas dla Linuksa, Dockera, reverse proxy i aktualizacji. Miejsce na dysku zajmują głównie zdjęcia i kopie zapasowe.

Scenariusz	CPU	RAM	Dysk
Prywatna baza z SQLite	1 vCPU	1 GB	10–20 GB SSD
Rodzina, HTTPS i inne kontenery	1–2 vCPU	2 GB	20 GB SSD lub więcej
PostgreSQL lub wielu użytkowników	2 vCPU	2–4 GB	20 GB SSD lub więcej

To praktyczne wartości początkowe, a nie ścisłe oficjalne minimum. Jeśli AI działa przez zewnętrzne API, obliczenia nie są wykonywane na VPS-ie. Zasoby potrzebne lokalnemu modelowi trzeba wyliczyć osobno.

SQLite czy PostgreSQL?

SQLite jest prostszy i według dokumentacji Mealie jest zalecany dla 1–20 użytkowników przy niewielkiej liczbie jednoczesnych operacji. W przypadku instalacji prywatnej lub rodzinnej zwykle jest najlepszym punktem wyjścia.

PostgreSQL warto wybrać przy dużym obciążeniu równoczesnym, gdy potrzebujesz wyszukiwania rozmytego albo gdy dane są przechowywane na pamięci sieciowej. SQLite nie jest zalecany na NAS-ie, ponieważ mogą wystąpić problemy z blokadami bazy i uszkodzeniem danych.

Instalacja Mealie na VPS-ie z Docker Compose

Poniższy przykład korzysta z SQLite. Docker Engine i Docker Compose muszą być już zainstalowane na serwerze. Odpowiedni będzie 64-bitowy system Ubuntu lub Debian na amd64 albo arm64.

1. Utwórz katalog

sudo mkdir -p /opt/mealie
cd /opt/mealie
sudo nano docker-compose.yml

2. Dodaj konfigurację

services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.24.0
    container_name: mealie
    restart: unless-stopped
    ports:
      - "9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: "1000"
      PGID: "1000"
      TZ: "Etc/UTC"
      BASE_URL: "https://recipes.example.com"

volumes:
  mealie-data:

Zastąp TZ i BASE_URL własnymi wartościami. Według stanu na 29 sierpnia 2026 roku aktualne wydanie to v3.24.0. Przed instalacją sprawdź najnowszą wersję i użyj konkretnego tagu zamiast latest, aby aktualizacja nie nastąpiła niespodziewanie.

3. Uruchom Mealie

sudo docker compose up -d
sudo docker compose ps

Otwórz http://SERVER_IP:9925. Domyślny login to [email protected], a hasło — MyPassword. Natychmiast zmień dane administratora.

4. Włącz HTTPS

Aby zapewnić stały dostęp, podłącz domenę, umieść przed Mealie Nginx, Caddy lub Traefik i wystaw certyfikat TLS. Następnie przypisz port do localhost:

ports:
  - "127.0.0.1:9925:9000"

Jeśli usługa jest potrzebna tylko w domu, możesz nie publikować jej w internecie i łączyć się przez VPN.

Co skonfigurować po uruchomieniu

Zmień hasło, upewnij się, że otwarta rejestracja jest wyłączona, i utwórz konta dla członków rodziny. Następnie dodaj kilka prostych tagów, na przykład „szybkie”, „do zamrażarki” i „kolacja”. Na początku zbyt złożona struktura tylko przeszkadza.

Zaimportuj kilka prawdziwych przepisów, sprawdź liczbę porcji i jednostki miary, dodaj dania do planera oraz utwórz pierwszą listę zakupów. Dzięki temu w jeden wieczór poznasz główny sposób pracy z Mealie.

Bezpieczeństwo i kopie zapasowe

Publiczna instalacja wymaga silnego hasła, HTTPS, zamkniętej rejestracji i regularnych aktualizacji. Dokumentacja osobno ostrzega przed metodami API importującymi URL-e: bez limitów częstotliwości żądań mogą generować niepotrzebne obciążenie. Najlepiej skonfigurować limit na reverse proxy.

Ponieważ podczas importu kontener łączy się z zewnętrznymi adresami, Mealie powinno być odizolowane od wewnętrznych usług w wrażliwej sieci domowej.

Panel administracyjny potrafi utworzyć, pobrać i przywrócić pełną kopię zapasową. Mealie nie wykonuje jednak automatycznych zaplanowanych kopii. Przy SQLite bezpieczniej jest również kopiować cały wolumen /app/data do zewnętrznego magazynu. Kopia zapisana na tym samym VPS-ie nie ochroni danych po utracie serwera.

Ograniczenia Mealie

Import zależy od struktury strony, dlatego niektóre karty przepisów trzeba poprawiać ręcznie. Skalowanie składników także może się mylić, jeśli oryginalny przepis używa swobodnego tekstu zamiast standardowych jednostek.

Głównym klientem jest interfejs WWW. Działa dobrze w mobilnej przeglądarce, ale aplikacje natywne są rozwijane osobno. Ponadto właściciel sam odpowiada za Dockera, HTTPS, aktualizacje i kopie zapasowe.

Mealie jest szczególnie skuteczne jako ciągły proces: zapisujesz znaleziony przepis, planujesz go na konkretny dzień i pamiętasz o kupieniu składników.

Mealie na VPS-ie od tropic.host

Domowy serwer sprawdzi się, jeśli działa bez przerwy i zdalny dostęp jest już skonfigurowany. VPS jest wygodniejszy, gdy przepisy i lista zakupów mają być dostępne z dowolnego miejsca bez przekierowywania portów na domowym routerze.

W przypadku instalacji rodzinnej możesz użyć linuksowego VPS-a od tropic.host z 2 GB RAM-u. To wystarczy na Mealie, Dockera i reverse proxy z rozsądnym zapasem. Możesz zacząć od SQLite, a wraz ze wzrostem obciążenia zwiększyć zasoby lub przejść na PostgreSQL.

VPS nie zastępuje kopii zapasowych: bazę danych i zdjęcia przepisów należy regularnie eksportować osobno.

Krótkie podsumowanie

Mealie przechowuje przepisy w uporządkowanym formacie, pomaga planować posiłki i łączy składniki we wspólną listę zakupów. Jego najmocniejszą funkcją jest import z linku, a dostęp rodzinny, planer i integracje zmieniają bibliotekę w codzienne narzędzie.

Do użytku prywatnego lub rodzinnego wystarczą mały VPS, Docker i SQLite. W zamian trzeba pilnować aktualizacji, HTTPS i kopii zapasowych.

FAQ

Czy Mealie jest bezpłatne?

Tak. Projekt jest rozpowszechniany na licencji AGPL-3.0. Koszty mogą dotyczyć VPS-a, domeny i zewnętrznych żądań AI.

Czy mogę importować przepisy ze stron w języku rosyjskim?

Tak, jeśli strona zawiera czytelną strukturę przepisu. Jakość zależy od serwisu; błędy można poprawić ręcznie lub przy użyciu importu wspomaganego przez AI.

Ile RAM-u potrzebuje Mealie?

W przypadku małej instalacji SQLite możesz zacząć od 1 GB. Jeśli VPS obsługuje Linuksa, reverse proxy i inne kontenery, praktyczniejsze będzie 2 GB.

Czy domena jest wymagana?

Nie. W sieci lokalnej lub przez VPN wystarczy adres IP. Do bezpiecznego dostępu z internetu wygodniejsze są domena i HTTPS.

Co wybrać: SQLite czy PostgreSQL?

SQLite jest prostszy i pasuje do większości instalacji z 1–20 użytkownikami. PostgreSQL lepiej sprawdzi się przy dużym obciążeniu równoczesnym, danych na NAS-ie lub wymaganym wyszukiwaniu rozmytym.