Servidor Local (via Docker)

Existem duas formas de rodar o PopinaFlow localmente:
App Desktop — programa instalável (Windows, Mac, Linux), sem precisar de Docker. Mais simples para a maioria dos restaurantes.
Servidor via Docker (esta página) — para quem quer sincronização automática com a nuvem ou gerencia múltiplas unidades.

O servidor local via Docker permite usar o PopinaFlow sem internet, diretamente na rede do seu restaurante. Tablets, celulares e caixas na mesma rede Wi-Fi funcionam normalmente — mesmo se a internet cair.

Quando a internet voltar, o sistema sincroniza automaticamente com a nuvem a cada 5 minutos.

Quando usar?

Internet instável ou ausente no local
Restaurante em área sem boa cobertura
Queda temporária do provedor
Desempenho mais rápido na rede local

Antes de começar: instalar o Docker

O servidor local usa o Docker para funcionar. É um programa gratuito que você instala uma única vez.

Abra o link: docker.com/products/docker-desktop
Clique em "Download for Windows"
Abra o arquivo baixado e siga o assistente de instalação
Reinicie o computador quando solicitado
Abra o Docker Desktop e aguarde o ícone de baleia aparecer na barra de tarefas

O Docker precisa estar aberto e rodando (ícone da baleia na barra de tarefas) antes de iniciar o servidor.

Passo 1 — Primeira vez: configurar e iniciar

Abra a pasta do PopinaFlow no seu computador
Dê duplo clique no arquivo Iniciar-Servidor.bat
Uma janela preta vai abrir — aguarde

Na primeira vez, o sistema vai:

Criar o arquivo de configuração automaticamente
Abrir o Bloco de Notas com esse arquivo

No Bloco de Notas, preencha as duas linhas obrigatórias:

JWT_SECRET=Cole aqui o valor do servidor em nuvem
SYNC_SERVICE_PASSWORD=Crie uma senha forte qualquer

Onde encontrar o JWT_SECRET? Peça ao técnico responsável pelo seu VPS em nuvem. Essa chave precisa ser idêntica à do servidor online.

Após preencher:

Pressione Ctrl + S para salvar
Feche o Bloco de Notas
Volte para a janela preta e pressione qualquer tecla para continuar

O sistema vai baixar e iniciar tudo automaticamente. Aguarde — na primeira vez pode levar de 5 a 10 minutos enquanto baixa as imagens.

Quando terminar, o navegador abre sozinho em http://localhost.

Passo 2 — Uso diário

Verifique que o Docker Desktop está aberto (ícone da baleia na barra de tarefas)
Dê duplo clique no arquivo Iniciar-Servidor.bat
Aguarde a mensagem "Popinaflow está rodando!"
O navegador abre automaticamente

Da segunda vez em diante é muito mais rápido — o sistema inicia em cerca de 30 segundos.

Passo 3 — Atualizar o sistema

Quando uma nova versão do PopinaFlow estiver disponível:

Verifique que o Docker Desktop está aberto
Dê duplo clique no arquivo Atualizar-Servidor.bat
Aguarde a mensagem "Atualização concluída!"

Importante: mantenha o computador conectado à internet durante a atualização. Os dados do restaurante não são perdidos.

Acessar de celular ou tablet

Após iniciar o servidor, a janela exibe o IP da rede local, por exemplo:

Rede local: http://192.168.1.10

Em qualquer dispositivo conectado ao mesmo Wi-Fi, abra o navegador e acesse esse endereço.

Dispositivo	O que acessar
Celular do cliente	`http://192.168.X.X/t/demo/menu`
Tablet do garçom	`http://192.168.X.X/t/demo/pdv`
Computador da cozinha	`http://192.168.X.X/t/demo/kitchen`
Computador do gerente	`http://192.168.X.X/t/demo/admin`

Substitua 192.168.X.X pelo IP exibido na janela do servidor. Substitua demo pelo slug do seu restaurante.

Modo Offline

O indicador de status

No topo do painel Admin, há um pequeno indicador colorido que mostra a situação da conexão com a nuvem:

Cor	O que significa
🟢 Verde	Conectado à nuvem — tudo sincronizado
🟡 Amarelo	Sincronizando agora, ou há pedidos aguardando envio
🔴 Vermelho	Sem internet — pedidos sendo salvos localmente

O indicador só aparece em instalações locais. No sistema em nuvem ele fica oculto.

O que funciona sem internet

A maioria das operações do dia a dia funciona normalmente mesmo sem conexão:

Funcionalidade	Sem internet
Cardápio digital	✅ Funciona
PDV (ponto de venda)	✅ Funciona
Pedidos e reservas	✅ Funciona (salvos localmente)
Mesas e comanda	✅ Funciona
Display da cozinha (Kitchen)	✅ Funciona
Fechar conta / registrar pagamento	✅ Funciona
Emissão de NF-e / NFS-e	❌ Requer internet
Upload de novas fotos de itens	❌ Requer internet
Sincronização automática com a nuvem	❌ Requer internet

Como a sincronização acontece

Quando a internet voltar, o sistema automaticamente envia todos os pedidos e reservas feitos offline para a nuvem. Isso ocorre em até 5 minutos sem nenhuma ação da sua parte.

O indicador muda de 🔴 para 🟡 enquanto sincroniza e volta ao 🟢 quando tudo estiver enviado.

Forçar sincronização manual

Se quiser sincronizar imediatamente sem esperar os 5 minutos, um administrador técnico pode acionar via API:

http

POST /api/sync/trigger
Authorization: Bearer <admin-jwt>

Ou entre em contato pelo Admin > Suporte para solicitar a sincronização manual.

Parar o servidor

Para encerrar o servidor local, feche a janela preta ou execute no terminal:

docker compose -f docker-compose.local.yml down

Solução de problemas

O Docker não está abrindo

Verifique se o computador foi reiniciado após a instalação
Abra o Docker Desktop manualmente pelo menu Iniciar
Se aparecer mensagem sobre WSL 2, clique em "Install" e reinicie

A janela fecha sozinha com erro

Verifique se o Docker Desktop está aberto (ícone da baleia na barra de tarefas)
Verifique se você está executando o .bat na pasta correta do PopinaFlow

O navegador não abre sozinho

Acesse manualmente: abra o navegador e digite http://localhost

"JWT_SECRET" em branco — sistema não inicia

Edite o arquivo backend\.env.local no Bloco de Notas
Preencha o JWT_SECRET e salve
Execute Iniciar-Servidor.bat novamente

Outros dispositivos não conseguem acessar

Verifique se estão na mesma rede Wi-Fi que o computador do servidor
Confirme o IP exibido na janela (pode mudar se o roteador reiniciar)
Desative temporariamente o firewall do Windows para testar

O sistema não sincroniza com a nuvem

Verifique a conexão com a internet no computador do servidor
Confirme que SYNC_SERVICE_PASSWORD no .env.local está correto
O sync ocorre automaticamente a cada 5 minutos

Dúvidas? Entre em contato pelo painel Admin > Suporte ou acesse o suporte online em popinaflow.com.

Servidor Local (via Docker) ​

Quando usar? ​

Antes de começar: instalar o Docker ​

Passo 1 — Primeira vez: configurar e iniciar ​

Passo 2 — Uso diário ​

Passo 3 — Atualizar o sistema ​

Acessar de celular ou tablet ​

Modo Offline ​

O indicador de status ​

O que funciona sem internet ​

Como a sincronização acontece ​

Forçar sincronização manual ​

Parar o servidor ​

Solução de problemas ​

O Docker não está abrindo ​

A janela fecha sozinha com erro ​

O navegador não abre sozinho ​

"JWT_SECRET" em branco — sistema não inicia ​

Outros dispositivos não conseguem acessar ​

O sistema não sincroniza com a nuvem ​