Nuvem central
Não há pacote para o clube instalar. A aplicação corre online e o clube entra por browser com a sua conta e a identidade técnica da instalação.
- Pacote
- Nenhum para o clube
- Quem instala
- ADMAzevedo
- Atualização
- Publicação central
Instalação
O GFutFree.pt pode ser usado em vários modelos técnicos. Para quem trabalha no clube, a experiência é sempre simples: abrir a aplicação num navegador atualizado. A instalação técnica depende de onde o clube ou a entidade responsável quer alojar o servidor.
Uma aplicação · quatro formas de alojar
Primeiro escolha onde vai correr o servidor
O GFutFree.pt é sempre a mesma aplicação gratuita, com as mesmas áreas funcionais e acesso por browser. O que muda é onde fica o servidor: na nuvem, num PC fixo da sede, num servidor Linux ou num servidor Windows. Esta separação evita misturar “acesso ao software”, “pacote”, “alojamento”, “download” e “quem instala”.
PC Windows na sede
Para clubes sem servidor. Um PC fixo da secretaria corre o servidor; os outros postos acedem por browser na rede local.
- Pacote recomendado
- ZIP windows-club com GFutFreeInstalar.exe
- Alternativa
- MSI, quando fizer sentido
- Quem instala
- Secretaria ou apoio técnico
Servidor Linux
Para VPS, alojamento compatível, cPanel, Plesk, Hestia, aaPanel ou servidor Linux do clube.
- Pacote
- .tar.gz self-hosted-linux
- Quem instala
- TI / fornecedor
- Atualização
- update.sh
Servidor Windows
Para quem já tem servidor Windows com IIS ou Apache, PHP e MySQL/MariaDB configurados.
- Pacote
- ZIP self-hosted-windows
- Quem instala
- TI / fornecedor
- Atualização
- update.ps1
Onde estão os downloads e os pacotes
O site institucional explica e aponta para os downloads, mas os pacotes e manifestos vivem no hub ADMAzevedo. Isto permite manter o www.gfutfree.pt leve e usar www.admazevedo.com como repositório técnico de instalação/atualização.
Versão oficial 2026.09.25.1 publicada nos quatro canais
A versão 2026.09.25.1 está ativa na nuvem central e com pacotes oficiais publicados no hub ADMAzevedo para PC da sede (ZIP e MSI) e servidores (Linux e Windows). O percurso de upgrade foi validado sobre instalações históricas de teste com preflight, backup/restore, migrations repetíveis e preservação total dos dados do clube. Esta versão oficial traz a certificação Strong Contract Path em 44/44 módulos e redesign transversal de UI/UX orientado a tarefas.
| Canal | Onde fica | Função |
|---|---|---|
| Informação pública | www.gfutfree.pt | Funcionalidades, acesso gratuito, estado, instalação, FAQ, termos e links externos para download. Não aloja pacotes. |
| Pacotes e manifestos | www.admazevedo.com/releases/gfutfree/ | Catálogo técnico, manifestos por variante, ZIP, MSI e tarballs. |
| Identidade e distribuição | www.admazevedo.com | Identificação técnica da instalação, registo de clubes, validação online e devolução do manifesto correto. Não serve para bloquear funcionalidades pagas. |
| Aplicação online | gfutfree.admazevedo.com | Ambiente onde clubes veem/testam a aplicação e onde são acompanhados desenvolvimentos. |
Assistente guiado
Escolha a sua situação e veja o pacote correto
Use este assistente quando não souber se deve escolher nuvem, PC da sede, servidor Linux ou servidor Windows. A versão atual é lida a partir dos manifestos do hub ADMAzevedo.
Assistente guiado
Escolha a sua situação e veja o pacote correto
Use este assistente quando não souber se deve escolher nuvem, PC da sede, servidor Linux ou servidor Windows. A versão atual é lida a partir dos manifestos do hub ADMAzevedo.
PC Windows na sede · windows-club · versão 2026.09.25.1
Para clubes sem servidor: usar um PC fixo da secretaria
Esta variante não é “nuvem” nem “servidor Windows”. É um PC fixo no clube a funcionar como servidor local. O método recomendado é descarregar o ZIP windows-club, extrair e executar GFutFreeInstalar.exe. O MSI continua disponível como alternativa, mas não deve ser confundido com o pacote self-hosted Windows. A versão Windows clube 2026.09.25.1 está indicada como pacote atual no hub ADMAzevedo; o GFutFree.pt apenas aponta para esses ficheiros. As variantes self-hosted Linux/Windows também foram publicadas em 2026.09.25.1.
Pacotes oficiais publicados
A linha Windows clube, self-hosted Linux e self-hosted Windows está publicada em 2026.09.25.1 no hub ADMAzevedo. As versões anteriores que apareçam em páginas de histórico são apenas registo cronológico.
Requisitos do PC Windows da sede
O PC precisa de
- Windows 10 ou Windows 11, 64-bit.
- Permissões de administrador na instalação.
- 8 GB RAM recomendados e 10 GB livres em disco.
- Rede local estável se outros PCs forem aceder.
- Firewall/antivírus configurados para permitir o serviço local.
O pacote inclui/prepara
- Backend Laravel e frontend compilado.
- PHP portátil, MariaDB e Visual C++ Runtime quando aplicável.
- Serviço local, ficheiro de ambiente e migrações.
- Atalhos para abrir, atualizar e reparar acesso quando necessário.
- Os restantes utilizadores só precisam de browser atualizado.
Antes de começar
Escolha um computador da sede que possa permanecer ligado sempre que o clube estiver a utilizar o GFutFree. Este será o PC servidor; a aplicação e a base de dados ficam instaladas apenas nele.
- Instale com uma conta Windows que tenha permissões de administrador.
- Use cabo de rede Ethernet sempre que possível e desative a suspensão automática durante o horário de utilização.
- Confirme que tem pelo menos 10 GB livres e que o Windows está atualizado.
- Se já existe uma instalação GFutFree, não faça uma instalação nova por cima: crie primeiro um backup e utilize o fluxo de atualização.
- Não exponha a porta da aplicação diretamente à Internet nem configure redirecionamentos no router. O acesso normal desta variante é pela rede local do clube.
Como instalar no PC da sede
- Descarregue o ZIP recomendado através do botão acima.
- Abra a pasta Transferências, clique com o botão direito no ZIP e escolha Extrair tudo. Não execute o instalador dentro do ficheiro comprimido.
- Abra a pasta extraída e faça duplo clique em GFutFreeInstalar.exe. Instalar-GFutFree.bat abre o mesmo assistente.
- Quando o Windows perguntar se permite alterações ao computador, escolha Sim; depois aceite os termos e selecione Instalar.
- Aguarde sem desligar o computador. O assistente prepara PHP, MariaDB, a base de dados, o serviço Windows GFutFreeWeb, a aplicação e os atalhos.
- No final, use o atalho GFutFree. O browser deverá abrir automaticamente no assistente de configuração inicial.
Firewall: se o Windows Defender perguntar em que redes permite comunicar, autorize em redes privadas. Não é necessário permitir em redes públicas.
Alternativa MSI: o MSI copia os ficheiros, mas a configuração continua a ser feita por GFutFreeInstalar.exe. Para instalações novas, prefira sempre o ZIP.
Primeira configuração do clube
Na primeira execução, o browser abre o onboarding. Preencha a identificação do clube, os dados pedidos e crie a conta de administrador do próprio clube. Guarde o email e a palavra-passe num local seguro.
- Use, por exemplo, [email protected] ou uma conta individual controlada pelo clube.
- O email [email protected] é apenas contacto de suporte e não deve ser usado como login.
- A chave ou identidade GFU identifica esta instalação e permite encaminhar as atualizações corretas; não cria módulos pagos.
- Depois de entrar, a validação pode ser consultada em Configurações → Licenciamento da App.
Se o browser não abrir, experimente http://127.0.0.1:8080. Se a porta 8080 já estava ocupada, utilize o endereço indicado pelo instalador.
Aceder a partir de outros computadores ou tablets
Os restantes equipamentos não instalam o GFutFree. Devem estar na mesma rede local e abrir, num browser atualizado, o endereço IP apresentado pelo instalador, por exemplo http://192.168.1.50:8080.
Endereço correto noutro PC
http://192.168.1.50:8080
O número varia conforme a rede. Guarde o endereço mostrado pelo instalador.
Endereços incorretos noutro PC
localhost ou 127.0.0.1
Estes endereços apontam sempre para o equipamento onde são escritos.
Para evitar que o endereço mude, peça a quem gere a rede para reservar um IP local ao PC servidor. Confirme também que a rede Wi-Fi não tem isolamento entre dispositivos.
Backups: responsabilidade do clube
As atualizações criam uma cópia de segurança antes de substituir ficheiros, mas isso não substitui uma política de backups do clube. Copie regularmente a pasta C:\Program Files\GFutFree-Clube\backups\ para um disco externo ou outro local seguro e protegido.
- Faça um backup antes de atualizações importantes, reinstalações, troca de disco ou mudança para outro computador.
- Não guarde a única cópia no mesmo disco do PC servidor.
- Periodicamente, confirme com apoio técnico que o backup pode ser restaurado.
Como atualizar o PC da sede
Quando existe uma versão nova e o PC tem Internet, o GFutFree pode apresentar uma janela de atualização. Escolha Sim para criar o backup, instalar a melhoria e voltar a abrir a aplicação.
Via normal
Use o atalho GFutFree - Atualizações. O atalho antigo GFutFree - Melhorias, quando existir, conduz ao mesmo fluxo.
Evite reinstalar
Não volte a executar o MSI nem crie uma instalação nova para aplicar correções. Só use outro pacote completo quando o suporte o indicar.
Uso no dia a dia
- O servidor corre em segundo plano como serviço Windows.
- O atalho GFutFree abre a aplicação no browser.
- Se a porta 8080 estiver ocupada, o configurador pode indicar outro endereço.
- Outros PCs da rede local só precisam de Edge, Chrome ou Firefox.
Atalhos e pastas principais
| Nome | Para quê |
|---|---|
| GFutFree | Abrir a aplicação no browser. |
| GFutFree - Atualizações | Verificar e instalar melhorias. |
| GFutFreeInstalar.exe | Configurar PHP, MariaDB, serviço, ambiente e migrações. |
| Repor-acesso-administrador.bat | Reparar permissões do administrador quando necessário. |
Aplicação: C:\Program Files\GFutFree-Clube. Logs de instalação e atualização: C:\ProgramData\GFutFree\Logs\. Backups da aplicação: C:\Program Files\GFutFree-Clube\backups\.
Problemas comuns
A página não abre no PC servidor
Abra http://127.0.0.1:8080, confirme que o serviço GFutFreeWeb está em execução e verifique firewall, antivírus e a porta indicada pelo instalador.
Fica parado em “A preparar instalação…”
Atualize primeiro o GFutFree. Se continuar, execute Repor-configuracao-inicial.bat como administrador ou abra http://127.0.0.1:8080/onboarding.
O administrador não tem permissões ou faltam botões
Execute Repor-acesso-administrador.bat como administrador; depois termine a sessão e volte a entrar.
Funciona no servidor, mas não nos outros PCs
Use o IP local do servidor, não localhost. Confirme a mesma rede, firewall privada, PC ligado, serviço iniciado e ausência de isolamento Wi-Fi.
A instalação apresenta um erro
Não reinstale repetidamente. Anote a versão, mensagem e momento do erro, tire uma captura de ecrã e envie os ficheiros de C:\ProgramData\GFutFree\Logs\ para [email protected]. Nunca envie palavras-passe ou códigos de autenticação.
Guia rápido para imprimir ou partilhar
- Descarregar o ZIP Windows Club e extrair tudo.
- Executar GFutFreeInstalar.exe como administrador.
- Permitir a comunicação em redes privadas quando solicitado.
- Aguardar pelo fim e concluir a configuração inicial do clube.
- Criar a conta de administrador do clube e guardar as credenciais em segurança.
- Guardar o endereço local apresentado para os restantes computadores.
- Manter o PC servidor ligado e sem suspensão durante a utilização.
- Fazer backups regulares fora do PC e usar GFutFree - Atualizações.
Nota honesta: a aplicação está em evolução ativa. Testar primeiro com dados controlados, manter backups e não substituir ERP fiscal certificado, faturação certificada, SAF-T, ATCUD ou obrigações legais externas.
Servidor Linux ou Windows: quando existe TI ou fornecedor
As variantes self-hosted não são para duplo clique de secretaria. São para quem já tem servidor, domínio, PHP, MySQL/MariaDB e capacidade de manutenção. O pacote não substitui o trabalho de alojamento, backups, SSL, segurança e atualizações do servidor.
Self-hosted Linux
- Pacote: GFutFree-SelfHosted-Linux-VERSAO.tar.gz.
- Requisitos: Linux 64-bit, PHP 8.2+, MySQL/MariaDB, nginx ou Apache.
- Document root: app/backend/public.
- Atualizações: ./update.sh.
Self-hosted Windows
- Pacote: GFutFree-SelfHosted-Windows-VERSAO.zip.
- Requisitos: Windows Server ou PC servidor, PHP 8.2+, MySQL/MariaDB, IIS ou Apache.
- Document root: app\backend\public.
- Atualizações: update.ps1.
Identidade técnica e atualizações
Todas as variantes podem validar a identidade técnica da instalação no hub ADMAzevedo. A aplicação envia a variante instalada, por exemplo cloud, club_package, self_hosted_linux ou self_hosted_windows. A resposta identifica o clube e devolve o manifesto de atualização correto. Este mecanismo organiza instalações e versões; a política atual não utiliza a licença para separar áreas funcionais pagas.
| Variante | deployment_mode | Pacote | Atualização |
|---|---|---|---|
| Nuvem central | cloud | Sem pacote para o clube | ADMAzevedo |
| PC Windows sede | club_package | ZIP windows-club recomendado; MSI alternativo | GFutFree - Atualizações / manifest windows-club |
| Servidor Linux | self_hosted_linux | tar.gz self-hosted-linux | update.sh |
| Servidor Windows | self_hosted_windows | ZIP self-hosted-windows | update.ps1 |
Limites honestos
O modelo de instalação não altera as fronteiras do produto: faturação certificada, SAF-T, ATCUD, PSP real, credenciais FPF/AF, observabilidade e restore continuam dependentes de validação técnica, legal ou contratual conforme o caso.