Você baixou um arquivo AppImage, tornou-o executável com o comando chmod e tentou abri-lo — e se deparou com esta mensagem:

AppImages require FUSE to run.

Não se preocupe. Esse é um dos problemas mais comuns enfrentados por usuários Linux com arquivos AppImage, e a correção costuma ser rápida e simples.

Por que o AppImage pede FUSE

O AppImage é um formato de empacotamento popular que permite aos desenvolvedores distribuir aplicações Linux como um único arquivo portátil. Para funcionar, um AppImage precisa se montar como um sistema de arquivos temporário, e para isso usa uma biblioteca chamada FUSE (Filesystem in Userspace).

A maioria dos arquivos AppImage é compilada para o FUSE 2. No entanto, muitas distribuições Linux mais recentes (como o Ubuntu 22.04 e posteriores) já vêm com o FUSE 3 por padrão, e a biblioteca antiga do FUSE 2 não é mais incluída. Quando a biblioteca necessária está ausente, o AppImage não consegue se montar e você recebe o erro acima.

A boa notícia: há duas formas simples de resolver isso.

A correção recomendada: instalar a compatibilidade com o FUSE 2

Esta é a correção mais limpa. Depois que a biblioteca ausente estiver instalada, seu AppImage vai rodar normalmente, sem etapas extras.

Escolha o comando correspondente à sua distribuição Linux. Todos os comandos desta seção exigem privilégios de administrador. Se você não tiver esses direitos, use a alternativa sem instalação.

Ubuntu / Debian / Linux Mint:

# For Ubuntu 22.04, Debian 12, Linux Mint, etc.
sudo apt install libfuse2
# For Ubuntu 24.04 and newer (the package was renamed)
sudo apt install libfuse2t64

Se aparecer um erro de "pacote não encontrado", habilite primeiro o repositório universe:

sudo add-apt-repository universe
sudo apt update
sudo apt install libfuse2

Fedora:

sudo dnf install fuse fuse-libs

Alguns usuários relataram que instalar também o pacote fuse-devel resolve certos problemas de dependência.

Arch Linux:

sudo pacman -S fuse2

openSUSE:

sudo zypper install fuse libfuse2

Depois de instalar, tente executar seu AppImage novamente. Se ainda falhar, saia da sessão e entre de novo, ou simplesmente reinicie o computador.

Alternativa sem instalação: executar o AppImage sem FUSE

Se você prefere não instalar pacotes extras ou não tem direitos de administrador na máquina, é possível dispensar o FUSE por completo. O AppImage inclui um modo de extração embutido que permite executar a aplicação diretamente.

Opção A: extrair e executar em uma única etapa

O comando abaixo descompacta o aplicativo em uma pasta temporária e o inicia, contornando totalmente a exigência do FUSE:

./YourFile.AppImage --appimage-extract-and-run

Substitua YourFile.AppImage pelo nome real do arquivo que você baixou.

Não sabe o nome exato do arquivo? Execute ls no terminal e procure o arquivo terminado em .AppImage. Use esse nome exato — maiúsculas e minúsculas fazem diferença. Se o nome do arquivo tiver espaços, coloque-o entre aspas, assim: "./My App.AppImage".

Opção B: extrair permanentemente

./YourFile.AppImage --appimage-extract

Isso cria uma pasta chamada squashfs-root no diretório atual. Em seguida, você pode executar a aplicação com:

./squashfs-root/AppRun

Essa abordagem é útil se você pretende usar o aplicativo com frequência, já que a extração é feita uma única vez.

Instalar ou extrair?

Instalar a biblioteca de compatibilidade é a correção mais limpa e faz o AppImage rodar normalmente, sem etapas extras. A extração é indicada quando você prefere não instalar pacotes extras ou não tem direitos de administrador. A extração permanente é útil se você usa o aplicativo com frequência, porque só precisa ser feita uma vez.

Perguntas frequentes (FAQ)

P: Instalar o FUSE é seguro?

R: Sim. O FUSE é um componente padrão e amplamente usado do ecossistema Linux. Instalar a biblioteca de compatibilidade do FUSE 2 é uma operação normal e segura.

P: Qual nome de pacote devo usar no Ubuntu 24.04?

R: Use libfuse2t64. No Ubuntu 24.04 e versões mais recentes, o pacote foi renomeado como parte da transição de time_t para 64 bits.

P: Por que muitos AppImages ainda dependem do FUSE 2?

R: Muitos arquivos AppImage são compilados contra o FUSE 2 porque ele oferece ampla compatibilidade entre distribuições. AppImages mais novos estão migrando gradualmente para o FUSE 3, mas a transição ainda está em andamento.

P: Preciso reinstalar o AppImage depois de corrigir isso?

R: Não. O problema está nas bibliotecas do seu sistema, não no arquivo AppImage em si. Depois que a biblioteca estiver instalada (ou que você usar o modo de extração), o mesmo arquivo vai funcionar.

Resumo

O erro "AppImages require FUSE to run" significa simplesmente que seu sistema não tem a biblioteca do FUSE 2 da qual a maioria dos arquivos AppImage depende. Para corrigir:

  1. Instale o pacote de compatibilidade do FUSE 2 para a sua distribuição (libfuse2 ou libfuse2t64 no Ubuntu/Debian), ou
  2. Execute o AppImage em modo de extração com --appimage-extract-and-run para dispensar o FUSE por completo.

De qualquer forma, você estará funcionando em poucos minutos.