Referência

Solução de problemas

O app não abre / “danificado” (macOS)

Os builds não são assinados. Clique-direito → Abrir, ou limpe a flag de quarentena:

xattr -cr /Applications/granspace.app

O SmartScreen bloqueia (Windows)

Escolha Mais informações → Executar assim mesmo — o instalador não é assinado.

Um projeto não é detectado

A detecção é dirigida por extensões. Garanta que o projeto tem um arquivo marcador reconhecido (ex.: package.json, composer.json, um arquivo compose). Instale uma extensão para outras stacks e rode Descobrir de novo.

Ações de git falham

O Granspace chama o git do sistema — garanta que ele está instalado e no PATH, e que o repositório tem o remote/credenciais que precisa.

O painel do Docker não aparece

Ele só aparece para projetos compose, e o Docker precisa estar instalado e no PATH. Veja Containers Docker.

Não consigo ver uma secreta

Valores secretos exigem o cofre destrancado com sua senha-mestra. Veja Secrets criptografados.

O app parece já estar aberto, ou um novo launch não faz nada

O Granspace roda em instância única. Se Manter rodando na bandeja estiver ligado, fechar a janela o deixa rodando na bandeja — abra pelo ícone da bandeja, ou Saia pelo menu da bandeja para encerrar de vez. Com a bandeja desligada, fechar a janela encerra. Veja Bandeja e menus.

Outra coisa está usando a porta dele

O app desktop escolhe uma porta livre automaticamente, então outro serviço numa porta qualquer não impede o app de iniciar.

Movendo o banco de dados

Aponte o Granspace para outro arquivo de banco com a variável de ambiente DB_PATH.