Instalar o Anotae no Linux (AppImage)¶

Tipo: How-to — "Como resolver problema X" Testado em: Ubuntu 22.04+, Fedora 38+, Arch Linux (rolling) Arquitetura: x86_64

O Anotae é distribuído como um AppImage autocontido para Linux. Não é necessário instalar pacotes do sistema além das bibliotecas gráficas básicas.

1. Pré-requisitos¶

Bibliotecas gráficas (obrigatórias)¶

O AppImage inclui Qt 6 e Python, mas depende de algumas bibliotecas do sistema:

# Ubuntu / Debian
sudo apt install libgl1-mesa-glx libegl1

# Fedora / RHEL / CentOS
sudo dnf install mesa-libGL mesa-libEGL

# Arch Linux
sudo pacman -S mesa libglvnd

FUSE (opcional)¶

Por padrão, AppImages usam FUSE para montagem. Em distribuições modernas com kernel ≥ 5.4, o FUSE 2 pode não estar instalado:

# Ubuntu / Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse

# Arch Linux
sudo pacman -S fuse2

Se preferir não instalar FUSE, veja a seção de solução de problemas — a variável APPIMAGE_EXTRACT_AND_RUN=1 elimina essa dependência.

`cosign` para verificação de autenticidade (recomendado)¶

# Baixar binário para Linux amd64
curl -L https://github.com/sigstore/cosign/releases/latest/download/cosign-linux-amd64 \
  -o cosign && chmod +x cosign && sudo mv cosign /usr/local/bin/cosign

2. Baixar o AppImage¶

Acesse a página de releases do Anotae:

https://github.com/carlosefdeavila/anotae/releases

Baixe os seguintes arquivos da versão mais recente:

Anotae-vX.Y.Z-x86_64.AppImage — o aplicativo
Anotae-vX.Y.Z-x86_64.AppImage.sigstore.json — attestation Sigstore
checksums.sha256 — hashes de todos os assets da release

Usando wget ou curl:

VERSION="v0.15-3"   # substitua pela versão mais recente
BASE="https://github.com/carlosefdeavila/anotae/releases/download/${VERSION}"

wget "${BASE}/Anotae-${VERSION}-x86_64.AppImage"
wget "${BASE}/Anotae-${VERSION}-x86_64.AppImage.sigstore.json"
wget "${BASE}/checksums.sha256"

3. Verificar a autenticidade via Sigstore¶

O Anotae usa Sigstore PEP 740 attestations geradas pelo GitHub Actions. A verificação garante que o binário corresponde exatamente ao código-fonte do repositório oficial.

Verificar com `cosign`¶

VERSION="v0.15-3"   # ajuste conforme necessário

cosign verify-attestation \
  --type slsaprovenance \
  --certificate-identity-regexp "https://github.com/carlosefdeavila/anotae/.*" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  "Anotae-${VERSION}-x86_64.AppImage"

Saída esperada (verificação bem-sucedida):

Verification for Anotae-vX.Y.Z-x86_64.AppImage --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate claims were validated

Verificar hash SHA-256 (alternativa simples)¶

sha256sum --check --ignore-missing checksums.sha256
# Saída esperada: Anotae-vX.Y.Z-x86_64.AppImage: OK

4. Tornar executável e executar¶

chmod +x Anotae-vX.Y.Z-x86_64.AppImage
./Anotae-vX.Y.Z-x86_64.AppImage

O Anotae abrirá diretamente. Na primeira execução, o assistente de configuração inicial solicita a criação da senha-mestra do vault.

5. Integração com o desktop¶

Instalação automática (recomendado)¶

O AppImage suporta instalação automática com ícone e entrada no menu de aplicativos:

./Anotae-vX.Y.Z-x86_64.AppImage --appimage-install

Isso cria: - ~/.local/share/applications/anotae.desktop — entrada no menu - ~/.local/share/icons/anotae.png — ícone do aplicativo

Após isso, o Anotae aparece no launcher do seu ambiente desktop e pode ser iniciado como qualquer outro aplicativo.

Instalação manual do arquivo `.desktop`¶

Se preferir controle total, mova o AppImage para ~/.local/bin/Anotae.AppImage e crie ~/.local/share/applications/anotae.desktop com os campos Name, Exec (caminho completo), Icon=anotae, Categories=Office;MedicalSoftware; e Terminal=false. Em seguida execute:

update-desktop-database ~/.local/share/applications/

6. Solução de problemas¶

FUSE não disponível — "FUSE library not found"¶

Se FUSE 2 não estiver instalado e você não quiser instalá-lo, use a variável de ambiente que extrai e executa o AppImage sem FUSE:

APPIMAGE_EXTRACT_AND_RUN=1 ./Anotae-vX.Y.Z-x86_64.AppImage

Para tornar permanente, adicione ao seu ~/.bashrc ou ~/.zshrc:

alias anotae='APPIMAGE_EXTRACT_AND_RUN=1 ~/.local/bin/Anotae.AppImage'

Ou edite o arquivo .desktop adicionando a variável ao campo Exec:

Exec=env APPIMAGE_EXTRACT_AND_RUN=1 /home/SEU_USUARIO/.local/bin/Anotae.AppImage

Erro "libGL.so not found" ou tela preta¶

Instale a biblioteca Mesa OpenGL:

# Ubuntu / Debian
sudo apt install libgl1-mesa-glx

# Fedora
sudo dnf install mesa-libGL

# Arch
sudo pacman -S mesa

Se o problema persistir, force o renderizador de software:

LIBGL_ALWAYS_SOFTWARE=1 ./Anotae-vX.Y.Z-x86_64.AppImage

Wayland — janela não abre ou exibe artefatos¶

O Anotae suporta Wayland via Qt 6. Se estiver usando Wayland e encontrar problemas:

# Forçar Wayland explicitamente
QT_QPA_PLATFORM=wayland ./Anotae-vX.Y.Z-x86_64.AppImage

# Fallback para XCB (X11/XWayland) se Wayland não funcionar
QT_QPA_PLATFORM=xcb ./Anotae-vX.Y.Z-x86_64.AppImage

Para uso permanente com Wayland, edite o arquivo .desktop:

Exec=env QT_QPA_PLATFORM=wayland /home/SEU_USUARIO/.local/bin/Anotae.AppImage

7. Desinstalar¶

Se usou `--appimage-install`¶

./Anotae-vX.Y.Z-x86_64.AppImage --appimage-uninstall

Manualmente¶

# Remover o AppImage
rm ~/.local/bin/Anotae.AppImage

# Remover integração com desktop
rm ~/.local/share/applications/anotae.desktop
rm -f ~/.local/share/icons/anotae.png

# Atualizar cache
update-desktop-database ~/.local/share/applications/

Remover dados do usuário (opcional)¶

Os dados do vault e configurações ficam em ~/.anotae/. Para remover completamente:

# ATENÇÃO: esta ação é irreversível. Faça backup antes.
rm -rf ~/.anotae/

Os dados de pacientes não são removidos por --appimage-uninstall — apenas o aplicativo. Você precisa remover ~/.anotae/ manualmente se desejar apagar os dados locais.