Distribuição Windows

Instalar POS Cash
no Windows

Descarrega um ficheiro ZIP, extrai e executa o instalador.
O POS Cash está a funcionar em minutos.

Descarregar POS Cash Ver documentação
v1.0.1 · Stable · Windows 10 / 11  +  Docker Desktop

Antes de começar

Requisitos

Garante que tens estes componentes instalados antes de iniciar.

Docker Desktop

Necessário para correr o POS Cash. Instala o Docker Desktop gratuitamente antes de prosseguir. Assegura-te de que o Docker está em execução antes de instalar.

Descarregar Docker

Windows 10 / 11

Compatível com Windows 10 (64-bit) e Windows 11. Não é necessária qualquer versão Pro ou Enterprise.

Internet no 1.º arranque

Necessária apenas na primeira instalação para transferir as imagens Docker. Depois, o POS Cash funciona completamente offline.

Instalação

3 passos para começar

Todo o processo demora menos de 5 minutos.

1

Descarregar e extrair o ZIP

Clica no botão de download acima e guarda o ficheiro. Extrai o conteúdo para uma pasta permanente no teu computador — por exemplo, C:\POSCash.

# Conteúdo do ZIP após extração
pos-customer-windows/
├── install-customer.bat
├── update-customer.bat
├── docker-compose.customer.yml
├── init-db.sql
└── INSTALL_CUSTOMER.md
2

Executar o instalador

Dentro da pasta extraída, faz clique duplo em install-customer.bat. O instalador arranca o Docker, inicializa a base de dados e configura tudo automaticamente.

# Clique duplo no ficheiro ou executar como administrador
install-customer.bat
Se o Windows apresentar um aviso de segurança, clica em "Mais informações" e depois em "Executar mesmo assim".
3

Aceder ao POS Cash

Após a instalação terminar, abre o teu browser e acede ao endereço abaixo. As credenciais iniciais são apresentadas no terminal durante a instalação.

# Abrir no browser
http://localhost:8080

Manutenção

Atualizar o POS Cash

Atualizações simples e seguras

Para atualizar para uma nova versão, executa o ficheiro update-customer.bat na pasta de instalação. O processo atualiza as imagens Docker sem apagar os teus dados.

# Executar para atualizar
update-customer.bat
Dados preservados Volume PostgreSQL persistente Histórico intacto

Dados de demonstração

Durante a instalação, podes optar por criar dados de demonstração — movimentos, utilizadores e fechos de caixa de exemplo. Útil para testar funcionalidades ou preparar uma apresentação antes de começares com dados reais.

Os dados de demo podem ser removidos a qualquer momento através do painel de administração.

Dúvidas

Perguntas frequentes

Não. O POS Cash é distribuído como um ficheiro ZIP pronto a usar. Não precisas de Git, Node.js, ou qualquer outra ferramenta de desenvolvimento.
Não. O instalador descarrega as imagens Docker publicamente disponíveis sem necessitar de login. Precisas apenas do Docker Desktop instalado e em execução.
Não. A base de dados PostgreSQL utiliza um volume Docker persistente. Os teus movimentos, utilizadores e configurações são preservados em todas as atualizações.
Sim. Após a instalação inicial (que requer internet para descarregar as imagens Docker), o POS Cash funciona completamente offline. A ligação à internet só é necessária novamente para futuras atualizações.
Sim. Podes usar o mesmo ZIP para instalar o POS Cash em múltiplos computadores. Cada instalação tem a sua base de dados local independente.
Executa novamente o install-customer.bat. O instalador é idempotente — retoma em segurança sem duplicar dados ou configurações.

Recursos técnicos

GitHub Releases Guia de instalação