> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/recursos/recursos/agente-linux.md).
# Instalação agente: Linux
Para instalar, siga os procedimentos abaixo:
## 🐧 Instalação do Agente Linux – Tiflux
***
### 🎯 Introdução
Este documento descreve o **procedimento completo para instalação, acesso remoto e desinstalação do agente Tiflux em ambientes Linux**, contemplando as particularidades de cada pacote e as distribuições homologadas.\
💡 **Importante:** O agente Tiflux para Linux foi homologado para as distribuições **Ubuntu 20.04 e Linux Mint 20**. Outras distribuições podem apresentar limitações de funcionalidades.
{% hint style="success" %}
Converse com seu Gerente de contas e adquira esta funcionalidade [Clique aqui](https://api.whatsapp.com/send?phone=551142008293\&text=Gostaria%20de%20mais%20informa%C3%A7%C3%B5es%20relacionadas%20a%20Agentes%20no%20Tiflux)
{% endhint %}
***
### 📚 Sumário
1. ✅ Pré-requisitos
2. 🛠️ Passo a Passo – Instalação Pacote `.tar.gz`
3. 🛠️ Passo a Passo – Instalação Pacote `.deb`
4. 🌐 Acesso Remoto no Linux
5. 🗑️ Desinstalação do Agente Linux
6. ⚙️ Observações Importantes
7. 🛠️ Troubleshooting
8. 🔗 Artigos Relacionados
9. ❓ Perguntas Frequentes (FAQ)
10. 🔍 Palavras-chave para IA, indexação e busca
***
### ✅ Pré-requisitos
* Distribuições homologadas: **Ubuntu 20.04** e **Linux Mint 20**.
* Acesso ao link de download do agente via menu **Recursos > Baixar Agente**.
* Sistema com **Systemd versão mínima v230**.
* Canal de suporte ativo para aquisição de pacotes ou esclarecimento de dúvidas.
* Apenas para x64
#### 📄 Documentações relacionadas:
* Instalação do Agente: Windows
* Instalação do Agente: Hyper-V
* Requisitos de Acesso Remoto no Tiflux
***
### 🛠️ Passo a Passo – Instalação Pacote `.tar.gz`
#### 1. Baixar o Agente no Tiflux
* Acesse **Recursos > Baixar Agente**.
* Selecione a opção **Linux (.tar.gz)**.
#### 2. Abrir o Terminal no Local do Arquivo
```bash
cd /home/suporte/downloads
```
#### 3. Executar os Comandos de Instalação
tar zfx nomedoarquivo.tar.gz
cd nomedoarquivo
make install
#### 4. Reiniciar o Computador
Após a instalação, recomenda-se reiniciar o sistema operacional para garantir a inicialização correta do agente.
***
### 🛠️ Passo a Passo – Instalação Pacote `.deb`
#### 1. Baixar o Agente no Tiflux
* Acesse **Recursos > Baixar Agente**.
* Selecione a opção **Debian/Ubuntu (.deb)**.
#### 2. Instalar o Pacote
**Com Ambiente Gráfico:**
* Basta **dar dois cliques no pacote baixado** para iniciar a instalação.
**Sem Ambiente Gráfico:**
```bash
cd /home/suporte/downloads
dpkg -i nomedoarquivo.deb
apt -f install # Executar apenas se houver dependências faltantes
```
***
### 🌐 Acesso Remoto no Linux
#### ✅ Compatibilidade:
* O acesso remoto no Tiflux é compatível **exclusivamente com o servidor gráfico Xorg.**
#### ⚠️ Limitações:
* **WayLand não é suportado.** (Exemplo: CentOS 8 utiliza WayLand por padrão).
* Systemd deve estar na versão **mínima v230** para pleno funcionamento da listagem e gerenciamento de serviços.
***
### 🗑️ Desinstalação do Agente Linux
#### 🔹 Versão 0.08 ou Superior:
```bash
/opt/tiflux/bin/tiflux-agent uninstall
```
#### 🔹 Versões Anteriores:
1. Faça download do script de desinstalação.
2. No terminal, vá até a pasta de download:
```bash
cd /home/suporte/downloads
chmod +x nomedoarquivo.sh
sudo ./nomedoarquivo.sh
```
💡 O script remove o agente de forma segura e completa.
{% file src="/files/-LyZeyiWVD54GF4Qdlbg" %}
Script Remover TiFlux
{% endfile %}
***
### ⚙️ Observações Importantes
* ✅ Homologado em **Ubuntu 20.04** e **Linux Mint 20**.
* ⚠️ Distribuições diferentes ou versões antigas podem apresentar limitações.
* ⚙️ Para funcionamento correto do agente, garanta a versão mínima v230 do Systemd.
* 🚫 Acesso remoto via WayLand **não é suportado.**
***
### 🛠️ Troubleshooting
| Problema | Possível Causa | Solução |
| ----------------------------------- | -------------------------------------------- | -------------------------------------------- |
| Erro de dependência | Pacotes ausentes no sistema | Executar `apt -f install` |
| Agente não abre | Sistema com WayLand ou Systemd desatualizado | Validar ambiente gráfico e versão do Systemd |
| Script de desinstalação não executa | Permissão insuficiente | Executar `chmod +x` no script |
***
### 🔗 Artigos Relacionados
* 📄 [Instalação do Agente: Windows](/sistema/recursos/recursos/agente-windows.md)
* 📄 [Instalação do Agente: Hyper-V](/sistema/recursos/recursos/instalacao-agente-hyper-v.md)
* 📄 [Instalação do Agente: Linux](/sistema/recursos/recursos/agente-linux.md)
* 📄 [Instalação do Agente: Mac](/sistema/recursos/recursos/agente-mac.md)
Importante: No Agente no linux não é possível visualizar as informações de software do recurso
***
### ❓ Perguntas Frequentes (FAQ)
**🔹** O agente funciona em qualquer distribuição Linux?\
Não. O agente foi homologado para **Ubuntu 20.04 e Linux Mint 20.** Outras distribuições podem apresentar limitações.
**🔹** O acesso remoto é compatível com todos os ambientes gráficos?\
Não. Apenas o servidor gráfico **Xorg é compatível.** O WayLand não é suportado.
**🔹** É necessário reiniciar o sistema após a instalação?\
Sim. É altamente recomendável reiniciar o computador para garantir que todos os serviços do agente sejam inicializados corretamente.
**🔹** Como remover o agente em versões antigas?\
Para versões anteriores a 0.08, é necessário utilizar o **script de desinstalação manual**, conforme orientado no passo a passo.
**🔹** É possivel ver informações de Software no Linux?\
Não, não é possível visualizar as informações de software do recurso se o Agente estiver instalado em sistema operacional Linux.
***
### 🔍 Palavras-chave para IA, indexação e busca
```plaintext
instalação agente Linux Tiflux,
agente Linux tar.gz,
agente Linux deb,
comando make install Linux,
dpkg Tiflux,
remoção agente Tiflux Linux,
script delete Tiflux Linux,
acesso remoto Xorg Tiflux,
compatibilidade WayLand Tiflux,
requisitos Systemd Tiflux,
Ubuntu 20.04 agente Tiflux,
Linux Mint 20 agente Tiflux
```
***
