O Freeplane não abre🔗

Sintoma. Você clica e nada acontece, ou uma janela de erro aparece e some, ou o programa inicia e trava na tela de abertura.

O que você vai aprender

Obter a mensagem de erro real, em vez de adivinhar pelo sintoma
Distinguir problema de Java, de perfil e de instalação
Voltar a abrir o programa sem perder configurações que valem a pena

Passo 1 — rode pelo terminal🔗

Não diagnostique às cegas. Executar pelo terminal mostra o erro:

freeplane

No Windows, use freeplaneConsole.exe, que mantém a janela de console aberta.

A mensagem que aparece resolve a maior parte dos casos.

Causa 1 — Java ausente ou incompatível🔗

java -version

O Freeplane 1.9+ precisa de Java 8 ou superior; versões recentes preferem Java 11 ou 17.

Sistema	Instalação
Debian/Ubuntu	`sudo apt install default-jre`
Arch	`sudo pacman -S jre-openjdk`
Fedora	`sudo dnf install java-17-openjdk`
macOS	`brew install openjdk@17`
Windows	Instalador do Adoptium/Temurin

Se houver várias versões instaladas, o Freeplane pode estar pegando a errada. Force:

JAVA_HOME=/usr/lib/jvm/java-17-openjdk freeplane

Sintoma típico de versão errada: UnsupportedClassVersionError.

Causa 2 — configuração corrompida🔗

Se o programa iniciava e parou de iniciar depois de alguma mudança, a configuração do usuário é a suspeita.

Teste sem apagar nada:

mv ~/.config/freeplane ~/.config/freeplane.bak
freeplane

Se abrir, o problema está na configuração. Recupere seletivamente:

# Traga de volta só o que importa
cp -r ~/.config/freeplane.bak/*/scripts   ~/.config/freeplane/1.11.x/
cp -r ~/.config/freeplane.bak/*/templates ~/.config/freeplane/1.11.x/
cp -r ~/.config/freeplane.bak/*/icons     ~/.config/freeplane/1.11.x/

Deixe auto.properties (as preferências) de fora — é o suspeito mais provável — e reconfigure à mão.

Causa 3 — add-on defeituoso🔗

Um add-on incompatível pode travar a inicialização. Se o problema começou logo depois de instalar um:

mv ~/.config/freeplane/1.11.x/addons ~/addons.bak
freeplane

Se abrir, devolva os add-ons um a um até achar o culpado.

Causa 4 — mapa problemático abrindo automaticamente🔗

Se a opção “abrir último mapa na inicialização” estiver ligada e esse mapa estiver corrompido, o programa trava antes de mostrar a interface.

freeplane --help    # confirme as opções da sua versão

Ou edite auto.properties e remova a entrada do último mapa aberto. Depois, trate o mapa por Mapa corrompido.

Causa 5 — memória insuficiente🔗

OutOfMemoryError na inicialização, com um mapa grande na sessão anterior:

_JAVA_OPTIONS="-Xmx4096m" freeplane

Causa 6 — display, em servidores🔗

HeadlessException ou Can't connect to X11 window server:

xvfb-run -a freeplane -S script.groovy mapa.mm

Ver Linha de comando e automação.

Causa 7 — permissões🔗

ls -la ~/.config/freeplane/

Se os arquivos pertencerem a outro usuário — o que acontece depois de rodar com sudo uma vez —, corrija:

sudo chown -R "$USER:$USER" ~/.config/freeplane

Nunca rode o Freeplane como root. É o que cria esse problema.

Causa 8 — instalação incompleta🔗

Se nada acima resolveu, reinstale a partir do pacote oficial:

freeplane.org ou o SourceForge do projeto — sempre a versão mais confiável.
O pacote da sua distribuição pode estar desatualizado ou empacotado de forma incompleta.
A versão portátil (um tarball que roda sem instalar) é útil para testar se o problema é da instalação ou do sistema.

Checklist🔗

[ ] Rodou pelo terminal e leu o erro?
[ ] java -version → 8 ou superior?
[ ] Configuração de usuário renomeada como teste?
[ ] Add-ons removidos como teste?
[ ] "Abrir último mapa" desligado?
[ ] -Xmx aumentado?
[ ] Permissões de ~/.config/freeplane corretas?
[ ] Testou a versão portátil oficial?

Você aprendeu

A primeira ação é rodar pelo terminal — sem a mensagem, todo o resto é chute
Java ausente ou incompatível responde pela maior parte dos casos
Um perfil corrompido é resolvido renomeando a pasta de configuração, não reinstalando
Reinstalar é o último passo, não o primeiro

Perguntas para reflexão

Por que rodar pelo terminal é o primeiro passo e não o último?
Como você distingue um problema de Java de um problema de perfil?
O que se perde ao renomear a pasta de configuração, e o que se preserva?
Em que ordem você tentaria as causas, e por quê?

O Freeplane não abre