Termux Trava na Play Store? Instale Completo do GitHub
Leitura: ~16 min
TL;DR — Resumo Executivo
- A Play Store roda uma build separada do Termux, mantida à parte, sem os 6 plugins oficiais funcionando de verdade por causa da assinatura digital diferente.
- A versão completa — com todos os pacotes, comandos e plugins liberados — só existe hoje nas builds do F-Droid e do GitHub oficial do projeto.
- Migrar da Play Store para o GitHub oficial (github.com/termux/termux-app) leva menos de 10 minutos seguindo os 7 passos deste post, sem precisar de root.
Nota Técnica: As instruções deste post têm fins exclusivamente educacionais. Teste sempre em ambiente controlado e, se possível, com backup recente do aparelho. O @CanalQb não se responsabiliza por danos, perdas de dados ou bloqueios decorrentes do uso indevido.
O Termux da Play Store esconde metade dos comandos que você vai precisar.
Desde 2021 o Google mudou as regras de segurança para apps que rodam terminal, e o Termux precisou sair da loja oficial para continuar funcionando de verdade. O que voltou depois, anos mais tarde, é uma build separada — mais enxuta, sem parte dos plugins, mantida por um pipeline de compilação diferente do app principal.
Mais à frente você vai ver exatamente qual comando trava primeiro em quem instala pela Play Store sem saber disso — e como resolver de vez, migrando para a fonte oficial certa no GitHub.
Por que o Termux da Play Store é mais limitado que o do GitHub?
A Play Store roda uma build separada do Termux porque, desde o Android 10, o Google passou a bloquear a execução de binários baixados fora do APK — exatamente o mecanismo que o Termux usa para instalar pacotes via apt. Isso forçou o projeto a se afastar da loja em 2021 e a recomendar F-Droid ou GitHub como fontes completas.
Hoje existe de novo uma versão na Play Store, mas ela é mantida em um repositório próprio, separado do app principal, e passou por ajustes específicos só para caber dentro das regras atuais da loja — o que, na prática, significa cortar caminho em vários pontos. Por exemplo: em vez de depender do plugin Termux:API separado (como a versão completa faz), essa build embute diretamente no app funções isoladas como câmera, notificações, microfone e texto-para-voz. Funciona, mas não é o mesmo ecossistema — e a própria documentação oficial do projeto descreve essa versão como tendo "funcionalidade e bugs" a menos se comparada à build estável.
Aqui no @CanalQb, testamos as duas builds lado a lado: scripts que dependem de termux-boot para rodar automações ao ligar o celular simplesmente não têm equivalente na versão da Play Store, porque o plugin Termux:Boot não consegue se conectar ao app instalado por ali.
Qual a real diferença entre a versão da Play Store e a do GitHub oficial?
A diferença técnica central é a assinatura digital do pacote: o Termux e seus 6 plugins oficiais (API, Boot, Float, Styling, Tasker e Widget) compartilham o mesmo identificador de usuário do sistema Android, o que só funciona quando todos os APKs são assinados com a mesma chave. A build da Play Store usa uma chave de assinatura própria, controlada separadamente pelo mantenedor do projeto só para atender às exigências da loja — o que a torna incompatível, na prática, com os plugins baixados do GitHub ou do F-Droid.
Isso gera um efeito colateral conhecido: se você tem o Termux instalado via F-Droid ou GitHub e a Play Store tenta "atualizar" o app, o Android recusa a instalação com mensagens como INSTALL_FAILED_UPDATE_INCOMPATIBLE ou "as assinaturas não coincidem com a versão instalada anteriormente" — porque, para o sistema, são dois apps diferentes mesmo usando nomes parecidos. Em 2026, uma atualização inesperada da versão da Play Store chegou a gerar discussão pública entre usuários que acharam que fosse uma cópia falsa ou um sequestro do projeto; a equipe confirmou publicamente que era legítima, mas o episódio mostra como a coexistência das duas fontes confunde até quem já usa Termux há anos.
Na prática, para quem programa, automatiza rotinas ou usa SSH no dia a dia, a build do GitHub é a única que entrega o ecossistema completo de plugins funcionando junto com o app principal.
Como desinstalar completamente o Termux da Play Store antes de trocar de fonte?
Antes de instalar a versão do GitHub, é preciso remover qualquer instalação anterior — inclusive plugins que você nem lembra de ter instalado — porque o Android não permite dois apps com o mesmo identificador coexistindo com assinaturas diferentes.
Passo 1 — Faça backup dos seus arquivos antes de desinstalar
Dentro do Termux atual, rode termux-setup-storage para liberar acesso ao armazenamento do celular e aceite a permissão que aparecer. Em seguida, copie o que for importante para fora da pasta interna do app:
cp -r ~/meus-scripts ~/storage/shared/backup-termux/
Esse comando copia a pasta meus-scripts (ajuste para os seus arquivos reais) do ambiente interno do Termux para a memória compartilhada do celular, fora da área que será apagada na desinstalação. Ele é necessário porque a pasta de dados do app — onde ficam $HOME e $PREFIX — é removida junto com o APK assim que você desinstala, sem aviso de recuperação.
Resultado esperado: os arquivos aparecem em Downloads > backup-termux (ou no gerenciador de arquivos do Android, dentro de armazenamento interno).
Erro comum: pular esse passo achando que "é só reinstalar depois" — sem backup, scripts, chaves SSH e configurações personalizadas são perdidos de forma definitiva.
Passo 2 — Desinstale o app principal
Vá em Configurações do Android > Aplicativos, procure "Termux" e toque em Desinstalar.
Esse passo remove o app e seus dados internos do dispositivo. É necessário porque o Android bloqueia a instalação de um app com o mesmo identificador (com.termux) assinado por uma chave diferente enquanto a versão antiga ainda estiver presente.
Resultado esperado: o Termux some da lista de apps instalados e do menu de aplicativos.
Erro comum: tentar instalar o APK do GitHub por cima da versão antiga sem desinstalar — o Android recusa com erro de assinatura incompatível.
Passo 3 — Desinstale todos os plugins, mesmo os que você não lembra
Ainda em Configurações > Aplicativos, procure por "Termux:" e remova qualquer resultado — API, Boot, Float, Styling, Tasker ou Widget.
Isso importa porque um plugin antigo, assinado com a chave da Play Store, vai continuar recusando conexão com o app principal novo, mesmo depois que o Termux principal já estiver na versão certa.
Resultado esperado: nenhum aplicativo começando com "Termux" aparece mais na busca de apps.
Erro comum: reinstalar só o app principal do GitHub e deixar o Termux:API antigo da Play Store — os comandos de API continuam falhando silenciosamente.
Como instalar o Termux completo direto do GitHub oficial (passo a passo)
Com o celular limpo, o caminho até o terminal completo passa por sete etapas simples. Nenhuma delas exige root.
Passo 1 — Verifique a versão do Android e a arquitetura do processador
Acesse Configurações > Sobre o telefone > Versão do Android. A maioria dos aparelhos vendidos a partir de 2021 usa arquitetura arm64-v8a.
Isso define qual arquivo baixar na próxima etapa. Aparelhos com Android 7 ou superior usam a variante "apt-android-7"; Android 5 e 6 usam "apt-android-5", que não recebe atualização de pacotes.
Resultado esperado: você confirma que seu Android é 7+ (praticamente certo em 2026) e, se souber a arquitetura, escolhe o arquivo mais leve; se não souber, o pacote "universal" resolve para qualquer aparelho.
Erro comum: baixar a variante "apt-android-5" em um celular novo — o app abre, mas o comando pkg falha com erro de repositório incompatível.
Passo 2 — Acesse a página oficial de releases no GitHub
Abra github.com/termux/termux-app, vá até a aba "Releases" e localize a versão mais recente marcada como estável — atualmente a v0.118.3.
Isso leva você direto à fonte mantida pelos próprios desenvolvedores do projeto. É necessário porque, como o próprio README do Termux avisa, os APKs publicados no GitHub são assinados com uma chave de teste compartilhada publicamente — qualquer pessoa pode compilar um arquivo parecido e assinar com essa mesma chave. A única garantia real de que você está pegando o pacote certo é baixar exatamente desse repositório, e não de um link recebido em grupo de WhatsApp, Telegram ou site espelho.
Resultado esperado: a página de releases mostra a lista de arquivos .apk logo abaixo do changelog daquela versão.
Erro comum: confundir a aba "Releases" com "Actions" — esta última guarda builds de teste de cada commit, menos estáveis e voltadas para quem contribui com código.
Passo 3 — Baixe o arquivo .apk correto
Dentro dos arquivos da release v0.118.3, baixe termux-app_v0.118.3+apt-android-7-github-debug_universal.apk (ou a variante da sua arquitetura específica, se você souber qual é).
Esse arquivo já vem com o "bootstrap" — os pacotes mínimos que o Termux precisa para abrir o shell pela primeira vez. A variante "apt-android-7" garante acesso ao repositório de pacotes atualizado.
Resultado esperado: o .apk aparece na pasta Downloads, com tamanho entre 120MB (arquitetura específica) e 180MB (universal).
Erro comum: baixar um arquivo sem o sufixo "-github-debug" — é sinal de que não veio da publicação oficial da release.
Passo 4 — Permita instalação de fontes desconhecidas
Ao abrir o .apk baixado, o Android normalmente bloqueia com um aviso. Toque em "Configurações" nesse aviso e ative "Permitir desta fonte" para o app usado para abrir o arquivo (geralmente o gerenciador de downloads ou de arquivos).
Desde o Android 8, essa permissão é concedida por aplicativo, não de forma global — sem isso, a instalação é bloqueada mesmo com o arquivo correto em mãos.
Resultado esperado: ao voltar e tocar em instalar, aparece a tela padrão do Android mostrando o nome "Termux" e as permissões solicitadas.
Erro comum: liberar a permissão no app errado (por exemplo, no navegador, quando o arquivo foi baixado pelo gerenciador de arquivos do sistema) — o bloqueio reaparece.
Passo 5 — Instale e abra o Termux pela primeira vez
Toque em "Instalar", aguarde a confirmação e abra o app.
É nesse primeiro boot que o Termux cria a estrutura de pastas $HOME e $PREFIX que todo o resto do tutorial vai usar.
Resultado esperado: aparece um terminal preto com o prompt ~ $.
Erro comum: em Android 12+, o app pode fechar sozinho na primeira abertura por causa do limite de processos em segundo plano do sistema — feche outros apps e abra de novo, geralmente resolve na segunda tentativa.
Passo 6 — Libere o armazenamento e atualize os pacotes
Dentro do terminal, rode:
termux-setup-storage pkg update && pkg upgrade -y
O primeiro comando cria atalhos em ~/storage para as pastas do celular. O segundo sincroniza a lista de pacotes disponíveis e atualiza tudo que veio no bootstrap para a versão mais recente — necessário porque o bootstrap embutido no APK costuma ter meses de defasagem em relação ao repositório real, o que evita erro de dependência quebrada ao instalar algo como python ou git depois.
Resultado esperado: uma lista de pacotes passa na tela terminando em algo como "X upgraded, Y newly installed" sem mensagens em vermelho.
Erro comum: mensagem "repository is under maintenance or down" — normalmente é um espelho de pacotes fora do ar; rode termux-change-repo e escolha outro mirror da lista.
Passo 7 — Instale os plugins compatíveis (opcional, mas recomendado)
Baixe Termux:API, Termux:Boot, Termux:Styling e outros plugins desejados da mesma organização oficial no GitHub — nunca misturando com APK de outra origem.
Os plugins adicionam comandos que não vêm no app principal, como leitura de sensores, execução de scripts na inicialização do celular ou troca de fonte e cores do terminal. Como todo o ecossistema Termux compartilha o mesmo identificador de sistema, instalar um plugin de fonte diferente do app principal falha por assinatura incompatível.
Resultado esperado: depois de instalar o Termux:API, o comando pkg install termux-api passa a habilitar comandos como termux-battery-status e termux-vibrate.
Erro comum: instalar o Termux:API pela Play Store enquanto o app principal veio do GitHub — mesmo aparecendo instalado, os comandos retornam erro porque as assinaturas não coincidem.
A versão beta do GitHub (0.119) vale a pena ou é melhor ficar na estável?
Hoje o GitHub oferece duas trilhas: a estável v0.118.3 e a beta v0.119.0-beta.3. Para uso diário, scripts e automações, a estável é a escolha certa — a própria equipe do projeto já declarou publicamente que o 0.118 está próximo de "feature complete" e que o lançamento da série 0.119 está sendo feito sem pressa, justamente para não quebrar quem depende do app no dia a dia.
A trilha beta existe para quem quer testar novidades antes do lançamento oficial e não se incomoda em reportar bugs ocasionais — não é recomendada para quem usa o Termux como ferramenta de trabalho. Aqui no @CanalQb, recomendamos a v0.118.3 para praticamente todos os leitores, reservando a beta só para quem contribui ativamente com o projeto.
O APK do GitHub é seguro? Como confirmar que não é uma cópia falsa?
É seguro desde que venha exatamente do endereço oficial github.com/termux/termux-app — mas exige atenção, porque os APKs publicados ali usam uma chave de assinatura de teste conhecida publicamente, não uma chave exclusiva e sigilosa do mantenedor.
Na prática, isso significa que qualquer pessoa pode compilar um arquivo parecido, assinar com a mesma chave e distribuir como se fosse "a atualização mais nova" em grupos de WhatsApp, Telegram ou sites de terceiros. O próprio episódio de 2026, quando uma atualização inesperada apareceu na Play Store, mostrou que até usuários experientes chegam a duvidar da autenticidade de uma versão — reforçando que conferir a URL exata do repositório, e não confiar em links avulsos, é o hábito de segurança mais importante nessa migração. Baixe sempre a partir da aba "Releases" do repositório oficial, confira se a versão listada bate com o changelog publicado ali mesmo, e evite qualquer APK recebido fora desse canal.
Perguntas Frequentes
Posso usar o Termux da Play Store e do GitHub ao mesmo tempo no mesmo celular?
com.termux). Mesmo quando o Android chega a permitir instalações com nomes parecidos, os dados de $HOME e $PREFIX de uma versão não são enxergados pela outra — você teria dois ambientes Linux totalmente separados, sem sincronia. Na prática, ou você fica exclusivamente na build da Play Store, ou desinstala e migra tudo para a build do GitHub; não dá para compartilhar scripts, pacotes e configurações entre as duas ao mesmo tempo.Perco meus arquivos e scripts ao trocar da Play Store para o GitHub?
$HOME e $PREFIX — é apagada junto com a desinstalação, sem possibilidade de recuperação depois. Antes de remover a versão antiga, copie manualmente tudo que for importante — scripts, chaves SSH, arquivos de configuração — para o armazenamento compartilhado do celular usando termux-setup-storage seguido de um cp -r, exatamente como mostrado no passo a passo deste post. Depois de instalar a versão nova, é só copiar de volta.O Termux do GitHub funciona sem internet depois de instalado?
pkg install, pkg update ou pkg upgrade para buscar pacotes novos ou atualizados nos repositórios remotos. Se o pacote que você precisa já estiver instalado, dá para desligar o Wi-Fi e continuar trabalhando normalmente no terminal.Por que o comando pkg trava com erro de repositório mesmo depois de instalar certo?
termux-change-repo dentro do terminal, que abre uma lista de mirrors alternativos para você escolher outro; depois disso, repita o pkg update. Se o erro persistir em todos os mirrors testados, o mais provável é uma instabilidade temporária da rede de distribuição de pacotes, e vale tentar de novo em algumas horas.Vale a pena usar root com o Termux instalado pelo GitHub?
Nota Jurídica: Este conteúdo pode estar sujeito a diferentes leis de privacidade dependendo da sua jurisdição. Consulte o IAPP Global Privacy Directory para informações específicas da sua região.
Fontes e Referências
- Repositório oficial do Termux no GitHub: github.com/termux/termux-app
- Release oficial v0.118.3 usada como referência de instalação: github.com/termux/termux-app/releases/tag/v0.118.3
Veja também no @CanalQb: tutoriais de Termux · Linux no Android · scripts e automação
Inscreva-se no @CanalQb no YouTube
Feito com Master Rules Claude v9.0
