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
lsno 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:
- Instale o pacote de compatibilidade do FUSE 2 para a sua distribuição (
libfuse2oulibfuse2t64no Ubuntu/Debian), ou - Execute o AppImage em modo de extração com
--appimage-extract-and-runpara dispensar o FUSE por completo.
De qualquer forma, você estará funcionando em poucos minutos.



