Mealie num VPS com Docker Compose: guia completo
Instale o Mealie num VPS com Docker Compose, extraia receitas por URL e configure planos de refeições, listas de compras, nginx, TLS e backups.
O que faz um gestor de receitas autoalojado
Um gestor de receitas autoalojado mantém as suas receitas numa base de dados num servidor que controla, e o Mealie é a opção escolhida pela maioria das famílias. Cole o endereço de uma página de receitas e o Mealie extrai os ingredientes, os passos, o rendimento e o tempo de confeção, deixando de fora o texto e a publicidade. O que fica na sua coleção é a receita.
O resto da aplicação é simples. Existe um plano semanal de refeições para onde pode arrastar receitas e uma lista de compras criada a partir desse plano. Cada pessoa que cozinha tem o seu próprio início de sessão. Tudo é executado num único contentor e permanece inativo entre pedidos, pelo que um VPS modesto o suporta sem problemas.
Este guia usa Docker Compose. Se os termos services: e volumes: forem novos para si, leia primeiro como são estruturados os ficheiros do Docker Compose, porque tudo o que segue consiste num único ficheiro compose e em quatro comandos.
Instalar o Mealie com Docker Compose
O Mealie publica as suas imagens no registo de contentores do GitHub. Em 18 November 2026, a tag estável atual é v3.31.0, publicada em 13 November. Esta versão inclui correções de segurança, e o projeto recomenda que todos façam a atualização. Fixe uma versão em vez de usar latest: com latest, um docker compose pull num dia sem relação pode fazer a atualização ultrapassar uma migração da base de dados para a qual ainda não estava preparado.
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:Antes de iniciar, há duas linhas que merecem atenção.
A porta está escrita como 127.0.0.1:9925:9000 e não como 9925:9000. O contentor escuta na porta 9000 internamente, e o host encaminha a porta 9925 para essa porta. Associar esse mapeamento ao endereço de loopback permite que o nginx alcance o Mealie, mas impede o acesso a partir da internet. O Docker escreve as suas próprias regras no filtro de pacotes, por isso um simples 9925:9000 fica acessível a partir do exterior mesmo quando a firewall indica que a porta está fechada. Vale a pena compreender esta particularidade uma vez: consulte por que as portas publicadas pelo Docker ignoram o ufw.
BASE_URL tem de ser exatamente o endereço público que vai usar, com o esquema e sem uma barra final. O Mealie cria a partir dele as ligações para reposição de palavras-passe e os convites. Se o definir como http://localhost:9925, o convite enviado ao seu parceiro conterá uma ligação que só funciona no próprio servidor.
Inicie o serviço e monitorize o primeiro arranque.
sudo docker compose up -d
sudo docker compose logs -f mealieO primeiro arranque cria a base de dados SQLite e executa as migrações, o que demora alguns segundos. Quando o log estabilizar e deixar de apresentar linhas de migração, verifique a aplicação localmente.
curl -I http://127.0.0.1:9925Um 200 OK significa que a aplicação está em execução. Se obtiver Connection refused, execute sudo docker compose ps -a para verificar o estado e o código de saída do contentor. Um contentor que parou com o código 137 recebeu SIGKILL; esse código, por si só, não mostra que tenha excedido o limite de memória de 1000M. Terminar o contentor manualmente também produz esse código.
Primeiro início de sessão e desativação do registo aberto
A conta predefinida é changeme@example.com e a palavra-passe é MyPassword. Inicie sessão com essa conta e altere imediatamente os dois valores, porque esse par está publicado na documentação e, por isso, é conhecido por todos os scanners.
ALLOW_SIGNUP: "false" no ficheiro compose é intencional. Com o registo aberto, qualquer pessoa que encontre o endereço pode criar uma conta na sua caixa de receitas. Com o registo fechado, adiciona pessoas na área de administração, que gera uma ligação de convite para enviar manualmente. Essa ligação é criada a partir de BASE_URL, por isso o valor é importante. Se acabar por executar várias aplicações no mesmo servidor e quiser usar uma única palavra-passe em todas, o Mealie pode delegar o início de sessão num fornecedor de identidade externo, como uma instância autoalojada do Authentik.
O Mealie coloca os utilizadores numa household, e as households ficam dentro de um grupo. Todos os utilizadores da mesma household partilham o plano de refeições e a lista de compras, que é o comportamento esperado numa família. A coleção de receitas é mais abrangente: as households partilham as receitas, etiquetas e categorias com todas as outras households do mesmo grupo. Assim, households separadas no mesmo servidor mantêm planos e listas separados, mas cozinham a partir das mesmas receitas. Isto também funciona numa casa partilhada onde ninguém concorda sobre as anchovas. Se as pessoas precisarem de coleções totalmente separadas, atribua-lhes grupos diferentes, porque nada é partilhado entre grupos.
O importador, que é o motivo para executar isto
Abra a coleção de receitas, escolha criar uma receita a partir de um URL e cole uma ligação. O Mealie obtém a página e procura dados estruturados de receitas, o bloco legível por máquinas que a maioria dos sites de receitas inclui para os motores de pesquisa. Quando esse bloco está presente, a importação é limpa e imediata.
Se configurar um fornecedor de IA, também pode importar a partir de uma imagem ou de texto simples colado por si, incluindo uma fotografia de uma página de um livro de receitas. A importação de imagens requer um fornecedor capaz de ler imagens. Sem um fornecedor, estas importações não estão disponíveis. O processamento segue um caminho mais lento e requer verificação posterior, porque é fácil interpretar mal uma fração escrita à mão.
As importações em massa são executadas a partir do mesmo ecrã: cole uma lista de endereços, um por linha, e o Mealie processa-os em segundo plano. Uma coleção com duzentos marcadores é transferida de uma só vez.
Planos de refeições e lista de compras
O planeador de refeições é um calendário. Arraste uma receita para um dia para a planear. Adicione as receitas planeadas a uma lista de compras para reunir os respetivos ingredientes. Para combinar duplicados, primeiro crie os alimentos e as unidades em Manage Data, ative as quantidades dos ingredientes em cada receita e analise os respetivos ingredientes para os associar a esses alimentos e unidades. Assim, duas receitas que necessitem de cebolas produzem uma linha, e não duas.
A lista fica disponível numa página atualizada em tempo real no seu telemóvel, enquanto está na loja. Como é alojada no seu próprio servidor, todas as pessoas da casa veem a mesma lista ao mesmo tempo. Quando uma pessoa assinala o leite como comprado, este desaparece do ecrã das outras pessoas.
Coloque o nginx e o TLS à frente
Neste cenário, o Mealie usa HTTP simples; também suporta TLS através de TLS_CERTIFICATE_PATH e TLS_PRIVATE_KEY_PATH. Termine o TLS no nginx, que fica à frente do serviço. Primeiro, aponte um registo DNS A para o servidor, porque a emissão do certificado verifica esse nome.
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 nginxA apresentação de nginx -t, syntax is ok e test is successful é a verificação decisiva. Faça reload apenas depois de essa verificação passar, porque recarregar uma configuração inválida mantém a configuração anterior em execução e oculta o erro até ao próximo restart.
client_max_body_size 64M existe porque o valor predefinido do nginx é 1 MB. Enviar uma fotografia de receita ou restaurar uma cópia de segurança pelo browser transmite um corpo maior do que esse limite. Sem essa diretiva, o nginx devolve 413 Request Entity Too Large, não o Mealie, e o log da aplicação não regista nada.
Depois, emita o certificado. Essa etapa e o respetivo timer de renovação são explicados em emitir um certificado Let's Encrypt para o nginx com o certbot.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comO Certbot reescreve o server block para escutar na porta 443 e adiciona um redirecionamento a partir da porta 80. Abra o site através de https:// e confirme que o browser aceita o certificado. Se o Mealie carregar, mas os próprios links redirecionarem para http://, então BASE_URL ainda indica http e precisa de ser corrigido. Em seguida, execute sudo docker compose up -d para recriar o contentor com o novo valor.
Servir o Mealie num subcaminho, como example.com/recipes, não funciona, porque o frontend não pode ser servido a partir de um subcaminho. Use um subdomínio.
Backups e o que uma restauração realmente faz
Tudo o que o Mealie gere fica em /app/data/ dentro do contentor, que é o volume mealie-data. Copiar esse volume copia em conjunto as receitas, as imagens e a base de dados. A documentação do Mealie indica que parar o contentor e copiar esta pasta é a melhor forma de fazer backup de uma instalação 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 mealieO nome do volume usa o nome do projeto como prefixo, e o nome do projeto é o diretório que contém o ficheiro compose. A partir de /srv/mealie, o volume é mealie_mealie-data, por isso o primeiro comando é docker volume ls: use o nome apresentado por esse comando, não o nome deste guia. É importante parar primeiro o contentor, porque o SQLite está frequentemente a escrever e uma cópia em execução pode ser restaurada de forma ilegível.
O Mealie também tem a sua própria página de backup na área de administração, que grava um arquivo zip contendo a base de dados como database.json. Um arquivo pode ser restaurado numa instância que execute a mesma versão ou uma versão mais recente do Mealie. Para mudar de servidor, execute a mesma versão fixada no novo servidor ao copiar o volume, ou restaure o arquivo na mesma versão ou numa versão mais recente. A restauração é destrutiva por definição: elimina a base de dados atual antes de carregar o arquivo e não pode ser anulada. A sessão é terminada quando o processo acaba.
Nenhuma das cópias é um backup enquanto permanecer no mesmo servidor. Envie o arquivo para outro local segundo um agendamento; é para isso que serve fazer backups encriptados fora do servidor com restic.
Atualizar o Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieAumente a versão fixada no ficheiro e, em seguida, faça pull e recrie o contentor. As migrações são executadas no primeiro arranque da nova imagem. Faça uma cópia do volume antes de alterar a versão principal, porque uma migração que falhe a meio pode deixar uma base de dados que a imagem anterior já não consegue abrir. Leia as notas de versão de todas as versões entre a sua versão atual e a nova versão.
Quando o importador falha
Alguns sites não publicam dados estruturados de receitas, e o Mealie importa nesse caso um título com a lista de ingredientes vazia. Sem um fornecedor de IA, não há uma configuração que resolva este problema, por isso cole manualmente o texto da receita. Com um fornecedor configurado, o Mealie envia o conteúdo da página para o modelo quando o scraper não encontra dados, e o resultado deve ser verificado contra a receita original, tal como qualquer outra importação feita com IA.
Outras falhas são causadas pela proteção contra bots à frente do site da receita, que responde ao Mealie com uma página de desafio em vez da receita. O Mealie já se faz passar por um browser e alterna o seu user agent para reduzir este problema. Quando um site continua a recusar o acesso, as opções documentadas são enviar o scraper através de um proxy com melhor reputação do endereço, ou executar uma instância do FlareSolverr que resolva o desafio num browser real. Ambas são opcionais e ambas são configuradas através de variáveis de ambiente no contentor.
Uma importação que falha porque o servidor não consegue alcançar o site é um problema diferente. Teste a partir do servidor com curl -I https://the-site.example/recipe e leia a linha de estado antes de atribuir o problema ao scraper. Desde a v3.26.0, o Mealie também recusa obter dados de endereços privados ou internos, por isso uma página de receita alojada na sua própria rede não será importada até adicionar o respetivo host à variável de ambiente HTTP_ALLOW_LIST.
Onde se enquadra
O Mealie é uma boa primeira aplicação self-hosted para uma casa, porque as pessoas com quem vive vão utilizá-lo sem ser necessário pedir-lhes. É o mesmo tipo de tarefa que a sua própria biblioteca de fotografias com o Immich, embora muito mais leve, e faz parte da lista mais ampla de coisas que vale a pena alojar por conta própria este ano. Um pequeno servidor pode alojar ambos. O Immich não é o único candidato para essa segunda tarefa e, se ainda estiver a decidir, os requisitos mínimos de memória e os comandos de backup do PhotoPrism e do Immich são suficientemente diferentes para justificar a leitura antes de ocupar o espaço restante do disco. Se a casa também mantiver os seus planos e notas no mesmo local que as suas receitas, um espaço de trabalho AFFiNE self-hosted é novamente o mesmo exercício com um ficheiro Compose, mas requer quatro contentores e muito mais memória do que o Mealie, por isso confirme primeiro os recursos disponíveis no servidor. E, se a casa quiser acompanhar os seus treinos além das receitas, o openGym mantém os treinos e requer a mesma tag fixa, ficheiro Compose e certificado que acabou de configurar. A noite depois do jantar tem a sua própria versão deste cenário, porque o Halcyon transforma uma biblioteca Jellyfin existente numa videolocadora dos anos 1990 que pode percorrer, acrescentando mais um pequeno contentor à frente de algo que já executa, em vez de outra base de dados para manter em backup. Nem tudo nesta família é uma aplicação doméstica e, se o mesmo hábito tiver de suportar alguma atividade profissional, uma central de suporte Chatwoot self-hosted requer novamente a mesma tag fixa e o mesmo certificado, com Postgres, Redis e o envio de correio de saída a funcionar por trás, sendo um serviço muito mais pesado do que uma caixa de receitas e merecendo um servidor próprio.
FAQ
Por que a importação de um URL de receita falha?
Há duas causas comuns. A página pode não publicar dados estruturados de receitas. Nesse caso, o scraper não encontra nada e, a menos que esteja configurado um fornecedor de IA para ler a página, obtém-se um título sem ingredientes. Também pode existir uma camada de proteção contra bots à frente do site, que devolve uma página de desafio em vez da receita. No segundo caso, o Mealie pode ser configurado para usar um proxy com melhor reputação de endereço ou uma instância autoalojada do FlareSolverr que resolva o desafio num navegador real. Antes de alterar qualquer coisa, confirme que o servidor consegue pelo menos alcançar a página com curl -I.
Preciso de PostgreSQL ou o SQLite é suficiente?
O SQLite é suficiente para uma família e é a opção predefinida. Mude para PostgreSQL quando o diretório de dados estiver num armazenamento ligado à rede, porque o SQLite sobre um sistema de ficheiros de rede produz erros de base de dados bloqueada e pode corromper o ficheiro. As restaurações com PostgreSQL exigem que o utilizador da base de dados seja um superutilizador, porque a restauração elimina tudo antes de carregar o arquivo.
Posso executar o Mealie sem um nome de domínio?
Sim, na sua própria rede. Defina BASE_URL como o endereço que vai realmente introduzir, por exemplo http://192.168.1.20:9925, altere o mapeamento de portas para 192.168.1.20:9925:9000 usando o endereço LAN do servidor e não configure o nginx. Execute sudo docker compose up -d para aplicar ambas as alterações. O mapeamento 127.0.0.1:9925:9000 original só aceita ligações provenientes do host Docker. As ligações de convite e de reposição da palavra-passe são construídas a partir de BASE_URL, pelo que um valor incorreto produz ligações que mais ninguém consegue abrir. Não o exponha à internet através de HTTP simples, porque nesse caso o início de sessão é enviado sem cifragem.
Como dou à minha família as suas próprias contas?
Mantenha ALLOW_SIGNUP definido como "false" e adicione as pessoas na área de administração. Isso gera uma ligação de convite que pode enviar-lhes. Coloque no mesmo agregado familiar todas as pessoas que partilham uma cozinha, para que partilhem o plano de refeições e a lista de compras. As receitas são partilhadas com todos os agregados do grupo de qualquer forma. Por isso, as pessoas que precisam de coleções separadas precisam de grupos separados.
O que acontece às minhas receitas se eu deixar de executar o Mealie?
As receitas podem ser extraídas. A cópia de segurança do administrador grava os seus dados em JSON, e o Mealie também pode exportar receitas como ficheiros JSON, que permanecem legíveis em qualquer editor de texto sem qualquer software. Faça uma exportação antes de precisar dela e confirme que consegue abri-la.