Mealie: seu próprio livro de receitas, planejador de cardápios e lista de compras em um VPS

Uma receita fica nos favoritos, outra em uma conversa, a terceira em uma captura de tela e a quarta precisa ser encontrada novamente em um site entre anúncios e uma longa introdução. O Mealie reúne tudo em um só lugar: você cola um link e recebe uma ficha com ingredientes, instruções e fotografia. Depois, pode adicionar o prato ao calendário e transferir os produtos para uma lista de compras compartilhada.

A seguir, veremos o que o Mealie faz, para quem ele é útil, qual servidor é necessário e como iniciar seu próprio gerenciador de receitas em um VPS com Docker Compose.

O que é o Mealie

O Mealie é um aplicativo gratuito e auto-hospedado para armazenar receitas, planejar refeições e gerenciar listas de compras. O serviço funciona no seu próprio servidor, portanto você decide onde o banco de dados fica armazenado, quem recebe acesso e como os backups são criados.

A interface é aberta no navegador de um computador ou telefone. As receitas podem ser criadas manualmente, importadas de sites, organizadas em categorias e livros de culinária, adicionadas a um cardápio semanal e compartilhadas com a família.

A principal diferença entre o Mealie e uma pasta de anotações é a conexão entre os elementos. Uma receita pode ser adicionada a um plano de refeições, vinculada a uma lista de compras, filtrada por etiquetas e usada em automações por meio da API.

Principais recursos do Mealie

Importação de uma receita por um único link

O usuário cola uma URL, e o Mealie tenta extrair o nome do prato, o número de porções, os ingredientes, as etapas e a imagem. Em vez de mais um favorito, fica uma ficha organizada que pode ser editada e salva.

Esse recurso é especialmente útil em sites nos quais a receita está cercada por anúncios e textos desnecessários. Quando uma página usa uma marcação fora do padrão, às vezes é preciso corrigir alguns dados manualmente.

O Mealie também consegue transferir coleções do Paprika, Tandoor, Nextcloud Cookbooks e de vários outros gerenciadores de receitas. Não é necessário começar com uma biblioteca vazia.

Importação a partir de foto, texto ou vídeo

Uma integração opcional com IA consegue montar uma receita a partir de texto, da fotografia de uma página de livro de culinária ou de um link de vídeo. No caso dos vídeos, o serviço obtém uma transcrição e depois extrai os ingredientes e a ordem das etapas.

Esse recurso exige um provedor de IA compatível. Você pode conectar uma API externa ou seu próprio serviço compatível com OpenAI, como o Ollama. Antes de ativá-lo, vale considerar o custo das requisições e a política de tratamento de dados do provedor escolhido.

Planejador de cardápios e lista de compras

Os pratos são organizados por dia e tipo de refeição. Você pode adicionar uma receita, uma anotação como “sobras de ontem” ou um prato aleatório com base em uma regra — por exemplo, escolher apenas jantares rápidos às sextas-feiras.

Os ingredientes das receitas são transferidos para a lista de compras. Os itens podem ser marcados pelo telefone e agrupados por seção da loja. Com isso, o Mealie deixa de ser apenas um arquivo e se torna uma ferramenta prática para a semana inteira.

Acesso familiar e automações

O Mealie oferece suporte a usuários, grupos e unidades familiares. Uma família pode usar uma coleção compartilhada de receitas e manter planos de refeições e listas de compras separados quando necessário.

A API REST, as notificações e os webhooks permitem conectar o serviço a outros sistemas. A integração oficial com o Home Assistant, por exemplo, mostra as próximas refeições no calendário e funciona com a lista de compras.

Para quem o Mealie é indicado

O Mealie é útil quando as receitas estão espalhadas por sites, anotações e fotografias; quando é preciso refazer o cardápio do zero; quando várias pessoas usam a mesma lista de compras; quando o controle sobre o próprio banco de dados é importante; ou quando são necessárias automações.

O serviço pode ser excessivo se você prepara apenas alguns pratos habituais e não quer manter o Docker. A auto-hospedagem elimina a dependência de uma conta em nuvem de terceiros, mas o servidor ainda precisa ser atualizado, protegido e incluído em backups.

Qual servidor o Mealie precisa

Na configuração oficial do Docker Compose, o contêiner é limitado a 1000 MB de memória. Para uma instalação pequena, 1 vCPU e 1 GB de RAM são suficientes, mas um VPS com 2 GB oferece folga para Linux, Docker, um proxy reverso e atualizações. O espaço em disco é usado principalmente para fotografias e backups.

Cenário	CPU	RAM	Disco
Banco pessoal com SQLite	1 vCPU	1 GB	SSD de 10–20 GB
Família, HTTPS e outros contêineres	1–2 vCPU	2 GB	SSD de 20 GB ou mais
PostgreSQL ou muitos usuários	2 vCPU	2–4 GB	SSD de 20 GB ou mais

Esses são valores iniciais práticos, não um mínimo oficial rígido. Se a IA funcionar por meio de uma API externa, os cálculos não serão executados no VPS. Os recursos para um modelo local precisam ser calculados separadamente.

SQLite ou PostgreSQL

O SQLite é mais simples e recomendado pela documentação do Mealie para 1–20 usuários com poucas operações simultâneas. Para uma instalação pessoal ou familiar, geralmente é o melhor ponto de partida.

Vale escolher PostgreSQL quando há uma carga simultânea elevada, necessidade de busca aproximada ou armazenamento dos dados em rede. Não é recomendado usar SQLite em um NAS, pois podem ocorrer bloqueios no banco e corrupção de dados.

Instalação do Mealie em um VPS com Docker Compose

O exemplo abaixo usa SQLite. O Docker Engine e o Docker Compose já devem estar instalados no servidor. Um sistema Ubuntu ou Debian de 64 bits em amd64 ou arm64 é adequado.

1. Crie um diretório

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

2. Adicione a configuração

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:

Substitua TZ e BASE_URL pelos seus próprios valores. Em 29 de agosto de 2026, a versão atual é a v3.24.0. Antes da instalação, confira a versão mais recente e use uma tag específica em vez de latest, para evitar uma atualização inesperada.

3. Inicie o Mealie

sudo docker compose up -d
sudo docker compose ps

Abra http://IP_DO_SERVIDOR:9925. O login padrão é [email protected], e a senha é MyPassword. Altere imediatamente as credenciais de administrador.

4. Ative o HTTPS

Para acesso permanente, vincule um domínio, coloque Nginx, Caddy ou Traefik na frente do Mealie e emita um certificado TLS. Depois, limite a porta ao localhost:

ports:
  - "127.0.0.1:9925:9000"

Se o serviço for necessário apenas em casa, você pode não publicá-lo na internet e acessá-lo por uma VPN.

O que configurar depois da inicialização

Altere a senha, verifique se o cadastro aberto está desativado e crie as contas dos familiares. Em seguida, adicione algumas etiquetas simples, como “rápido”, “pode ser congelado” e “jantar”. Uma estrutura complicada demais só atrapalha no começo.

Importe algumas receitas reais, confira as porções e unidades de medida, adicione pratos ao planejador e monte sua primeira lista de compras. Assim, o principal fluxo de uso do Mealie fica claro em uma única noite.

Segurança e backups

Uma instalação pública precisa de senha forte, HTTPS, cadastro fechado e atualizações regulares. A documentação alerta separadamente sobre os métodos da API que importam URLs: sem limitar a frequência das requisições, eles podem gerar carga desnecessária. É melhor configurar um limite de requisições no proxy reverso.

Como a importação faz o contêiner se conectar a endereços externos, em uma rede doméstica sensível o Mealie deve ser isolado dos serviços internos.

No painel de administração, é possível criar, baixar e restaurar um backup completo. Porém, o Mealie não executa mais backups automáticos agendados. Com SQLite, também é mais seguro copiar todo o volume /app/data para um armazenamento externo. Um backup no mesmo VPS não protegerá contra a perda do servidor.

Limitações do Mealie

A importação depende da marcação do site, por isso algumas fichas precisam ser corrigidas manualmente. O redimensionamento das quantidades dos ingredientes também pode apresentar erros quando a receita original usa texto livre em vez de unidades padronizadas.

O principal cliente é a interface web. Ela funciona bem em um navegador móvel, mas os aplicativos nativos são desenvolvidos separadamente. Além disso, o proprietário é responsável pelo Docker, HTTPS, atualizações e backups.

O Mealie é especialmente eficiente como um processo contínuo: salvar uma receita encontrada, programá-la para um dia e não esquecer os ingredientes.

Mealie em um VPS da tropic.host

Um servidor doméstico é adequado quando funciona continuamente e o acesso remoto já está configurado. Um VPS é mais conveniente quando as receitas e a lista de compras precisam estar disponíveis de qualquer lugar, sem encaminhar portas pelo roteador de casa.

Para uma instalação familiar, você pode usar um VPS Linux da tropic.host com 2 GB de RAM. Isso é suficiente para Mealie, Docker e um proxy reverso com uma margem razoável. É possível começar com SQLite e, conforme a carga crescer, aumentar os recursos ou migrar para PostgreSQL.

Um VPS não substitui os backups: o banco de dados e as fotografias das receitas devem ser exportados separadamente com regularidade.

Conclusão breve

O Mealie armazena receitas em um formato limpo, ajuda a planejar cardápios e reúne os ingredientes em uma lista de compras compartilhada. Seu recurso mais forte é a importação por link, enquanto o acesso familiar, o planejador e as integrações transformam a biblioteca em uma ferramenta para o dia a dia.

Para uso pessoal ou familiar, um VPS pequeno, Docker e SQLite são suficientes. Em contrapartida, será necessário acompanhar as atualizações, o HTTPS e os backups.

FAQ

O Mealie é gratuito?

Sim. O projeto é distribuído sob a licença AGPL-3.0. Podem existir custos com o VPS, o domínio e as requisições externas de IA.

É possível importar receitas de sites em russo?

Sim, desde que a página contenha uma marcação de receita compreensível. A qualidade depende do site; os erros podem ser corrigidos manualmente ou com a importação por IA.

Quanta RAM o Mealie precisa?

Para uma instalação pequena com SQLite, você pode começar com 1 GB. Para um VPS com Linux, proxy reverso e outros contêineres, 2 GB são mais práticos.

É necessário ter um domínio?

Não. Em uma rede local ou por uma VPN, um endereço IP é suficiente. Para acesso seguro pela internet, um domínio e HTTPS são mais convenientes.

O que escolher: SQLite ou PostgreSQL?

O SQLite é mais simples e atende à maioria das instalações com 1–20 usuários. O PostgreSQL é melhor para carga simultânea elevada, armazenamento em NAS ou quando é necessária busca aproximada.