SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

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.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:

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 mealie

O 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:9925

Um 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/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

A 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.com

O 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 mealie

O 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 mealie

Aumente 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.

Este artigo foi útil?