Documentação
Guia de instalação
POS Cash Windows
Tudo o que precisas para instalar, atualizar e manter
O POS Cash no Windows.
Antes de começar
Requisitos
Garante que tens estes componentes antes de iniciar a instalação.
Docker Desktop
Necessário para correr o POS Cash. Instala e inicia o Docker Desktop antes de executar o instalador.
Descarregar DockerWindows 10 / 11
Compatível com Windows 10 (64-bit) e Windows 11. Não é necessária versão Pro ou Enterprise.
Ligação à internet
Necessária apenas na primeira instalação para descarregar as imagens Docker. Depois funciona offline.
Instalação
Passo a passo
Segue a ordem indicada. Todo o processo demora menos de 5 minutos.
Descarregar o ZIP
Vai à página de download e clica em "Descarregar POS Cash". Guarda o ficheiro num local de fácil acesso.
Extrair o ficheiro
Extrai o conteúdo do ZIP para uma pasta permanente. Recomendamos uma localização fora de Downloads para evitar apagar por engano.
C:\POSCash\
├── scripts/
│ ├── install-customer.bat
│ └── update-customer.bat
├── docker-compose.customer.yml
├── init-db.sql
└── INSTALL_CUSTOMER.md
Executar o instalador
Dentro da pasta extraída, vai à subpasta scripts/ e faz clique duplo em install-customer.bat. O instalador configura tudo automaticamente.
scripts\install-customer.bat
Escolher dados de demonstração
Durante a instalação, o instalador pergunta se pretendes criar dados de demonstração — movimentos, utilizadores e fechos de caixa de exemplo.
Abrir o POS Cash
Quando a instalação terminar, abre o browser e acede ao endereço abaixo. As credenciais de acesso são apresentadas no terminal durante a instalação.
http://localhost:3000
Manutenção
Atualizar o POS Cash
Processo de atualização
Para atualizar para uma nova versão, executa o ficheiro update-customer.bat na pasta scripts/. O processo descarrega as novas imagens Docker e reinicia os serviços.
scripts\update-customer.bat
Base de dados
Persistência de dados
Volume Docker persistente
O POS Cash usa PostgreSQL num volume Docker dedicado. Os dados existem fora dos containers — instalar, atualizar ou reiniciar não apaga nada.
O volume é criado automaticamente na primeira instalação e mantido em todas as atualizações.
docker compose down -v
O flag -v apaga os volumes Docker, incluindo toda a base de dados PostgreSQL. Esta operação é irreversível. Usa este comando apenas se pretenderes fazer um reset total e perder todos os dados.
Resolução de problemas
Troubleshooting
Docker Desktop não está em execução
O instalador requer que o Docker Desktop esteja ativo. Se recebes um erro como Cannot connect to the Docker daemon, o Docker não está a correr.
Solução: Abre o Docker Desktop a partir do menu Iniciar ou do ícone na barra de tarefas. Aguarda até o ícone ficar estável (sem animação de carregamento) e executa o instalador novamente.
Porta 3000 já está em uso
Se recebes um erro de conflito de porta, outro processo está a usar a porta 3000.
Identificar o processo:
netstat -ano | findstr :3000
Terminar o processo: Usa o Task Manager (Gestor de Tarefas) para encerrar o processo com o PID encontrado acima, ou altera a porta no ficheiro docker-compose.customer.yml.
Ver logs dos containers
Para diagnosticar erros de arranque ou comportamento inesperado, consulta os logs em tempo real:
docker compose logs -f
# Logs apenas do serviço de aplicação
docker compose logs -f app
# Logs apenas da base de dados
docker compose logs -f db
Reset total (apaga todos os dados)
Se precisares de reiniciar do zero — apagar toda a base de dados e configuração — usa o seguinte comando na pasta de instalação:
docker compose down -v
Todos os movimentos, utilizadores, fechos de caixa e configurações são apagados permanentemente. Faz um backup da base de dados antes de prosseguir se precisares de preservar algum dado.
Depois do reset, executa novamente scripts\install-customer.bat para uma instalação limpa.