# Instalação do DWAgent

O DWAgent é o componente principal do DWService, uma solução gratuita e de código aberto para acesso remoto, administração e suporte a dispositivos via navegador web. Este manual guia você através dos passos para instalar e configurar o DWAgent em diferentes sistemas operacionais: Windows, Linux e macOS.

## Pré-requisitos

* Uma conta no DWService (crie uma gratuitamente em <https://www.dwservice.net/pt\\_BR/home.html>).
* Conexão com internet no dispositivo onde o agente será instalado.
* Direitos de administrador no sistema.

{% stepper %}
{% step %}

### Criando uma Conta no DWService

* Acesse o site <https://www.dwservice.net/pt\\_BR/home.html>.
* Clique em **"Ainda não está registrado? Registre-se aqui."**.
* Preencha os campos com seu e-mail, senha e outras informações solicitadas.
* Confirme o e-mail de verificação enviado para sua caixa de entrada.
* Faça login na sua conta.

{% hint style="info" %}
Use uma senha forte. O DWService não armazena senhas em texto plano para maior segurança.
{% endhint %}
{% endstep %}

{% step %}

### Adicionando um Agente no Painel

Antes de instalar, registre um agente no seu dashboard:

* No painel do DWService (após login), clique em **"Adicionar Agente"** ou vá para a seção de agentes.
* Escolha o método de instalação:
  * **Com Código de Instalação (Installation Code):** Recomendado para instalações manuais. O sistema gera um código numérico único.
  * **Com Credenciais (Credentials):** Configure um usuário (seu e-mail) e uma senha de instalação separada (não use a senha da conta para segurança).
* Anote o código ou credenciais gerados – você precisará deles durante a instalação.

{% hint style="info" %}
Para credenciais, acesse **Configurações > Credenciais** no painel e defina uma senha de instalação diferente da senha da conta.
{% endhint %}
{% endstep %}

{% step %}

### Baixando o DWAgent

* No painel do DWService, vá para a página de **Download** (ou acesse diretamente <https://www.dwservice.net/download.html>).
* Selecione a versão correspondente ao seu sistema operacional:
  * Windows: `dwagent.exe`
  * Linux: `dwagent.sh`
  * macOS: `dwagent.dmg`
* Clique em **Download** e salve o arquivo no dispositivo alvo.
  {% endstep %}

{% step %}

### Instalação por Sistema Operacional

#### Instalação no Windows

**Método com Código de Instalação**

* Execute o arquivo `dwagent.exe` baixado (clique duplo).
* Um assistente (wizard) será aberto. Clique em **Next** para prosseguir.
* Aceite os termos de licença e clique em **Next**.
* Escolha o diretório de instalação (padrão: `C:\Program Files\DWAgent`) e clique em **Next**.
* Selecione **"Creating a new agent"** e clique em **Next**.
* Insira o **Código de Instalação** gerado no Passo 2.
* Clique em **Next** e aguarde a instalação.
* Ao final, um ícone **DWAgent Monitor** aparecerá na barra de tarefas. Clique nele para verificar o status (deve mostrar "Online").

**Método com Credenciais**

* Siga os passos acima até selecionar **"Creating a new agent"**.
* Insira:
  * Usuário: Seu e-mail da conta DWService.
  * Senha: A senha de instalação configurada nas credenciais.
* Prossiga com **Next** e finalize.

{% hint style="info" %}
Instalação Silenciosa (para scripts ou GPO): use:

{% code title="Comando de instalação silenciosa (Windows)" %}

```
```

{% endcode %}

(substitua `SEU_CODIGO` pelo código de instalação)
{% endhint %}

***

#### Instalação no Linux (Console ou GUI)

**Método com Código de Instalação (Console)**

```bash
cd ~/Downloads
wget -N https://www.dwservice.net/download/dwagent.sh
chmod +x dwagent.sh
sudo bash dwagent.sh -console
# Siga o assistente: confirme caminho (padrão /usr/share/dwagent), selecione opções e insira o Código de Instalação
# Verifique o status:
systemctl status dwagent
```

**Método com GUI (se disponível)**

* Execute:

```bash
sudo bash dwagent.sh
```

* Siga o assistente gráfico, inserindo o código conforme solicitado.

**Método com Credenciais (Console)**

* Baixe e torne o script executável conforme acima.
* No assistente, escolha a opção para criar um novo agente com credenciais e insira e-mail e senha de instalação.

{% hint style="warning" %}
O DWAgent roda como root por padrão. Para rodar como usuário não-root, edite o serviço systemd após instalação:

```bash
sudo systemctl edit dwagent
```

{% endhint %}

***

#### Instalação no macOS

**Método com Código de Instalação**

* Abra o arquivo `dwagent.dmg` baixado.
* Arraste o app para a pasta **Aplicações**.
* Abra o Terminal e execute:

```bash
sudo /Applications/DWAgent.app/Contents/MacOS/Install
```

* No assistente:
  * Escolha o caminho (padrão: `/Library/DWAgent`).
  * Selecione **"Creating a new agent"**.
  * Insira o **Código de Instalação**.
* Conceda permissões:
  * Vá para **Preferências do Sistema > Privacidade e Segurança > Acessibilidade**.
  * Adicione `/Library/DWAgent/native/DWAgentSvc.app` à lista e ative.

**Método com Credenciais**

* Siga os passos acima, mas insira e-mail e senha de instalação no lugar do código.

{% hint style="info" %}
Instalação Silenciosa (macOS): crie um script `dwagent.sh` com o conteúdo abaixo e execute com `sudo sh dwagent.sh`:

{% code title="dwagent.sh (exemplo de instalação silenciosa macOS)" %}

```
```

{% endcode %}

(substitua `SEU_CODIGO` pelo código de instalação)
{% endhint %}
{% endstep %}

{% step %}

### Configuração Inicial e Conexão

* Após a instalação, o DWAgent deve iniciar automaticamente e se conectar ao servidor DWService (verifique o ícone do monitor: verde para online).
* No painel web do DWService, o agente aparecerá na lista de dispositivos.
* Para configurar opções avançadas:
  * Clique no agente no painel > **Configurar**.
  * Ajuste idioma, notificações, aplicações disponíveis (ex: Tela, Arquivos, Processos).
  * Defina grupos para organização (útil para múltiplos agentes).
* Para conectar remotamente:
  * No navegador, acesse <https://www.dwservice.net> e faça login.
  * Selecione o agente e inicie a sessão (controle de tela, arquivos, etc).

{% hint style="info" %}
Aplicações Disponíveis: dependendo do SO, você terá acesso a Tela Remota, Gerenciador de Arquivos, Terminal, Monitor de Logs, etc.
{% endhint %}
{% endstep %}
{% endstepper %}

## Solução de Problemas

<details>

<summary>Agente offline</summary>

* Verifique firewall (portas 80/443), antivírus e conexão de internet.
* Reinicie o serviço:
  * Windows: abra Services (`services.msc`) e reinicie o serviço DWAgent.
  * Linux: `sudo systemctl restart dwagent`
  * macOS: reinicie via launchctl.

</details>

<details>

<summary>Erro de código/credenciais</summary>

* Gere um novo código/credenciais no painel do DWService e reinstale.

</details>

<details>

<summary>Permissões negadas (macOS)</summary>

* Reative permissões em **Preferências do Sistema > Privacidade e Segurança** e adicione o componente nativo do DWAgent à lista de Acessibilidade/Automação conforme necessário.

</details>

<details>

<summary>Logs</summary>

* Consulte logs para depuração:
  * Windows: `C:\Program Files\DWAgent\logs`
  * Linux: `/usr/share/dwagent/logs`

</details>

## Instalação Avançada

* Silenciosa em Massa: use scripts com parâmetros `-silent` para deploy em rede.
* Integração API: para desenvolvedores, consulte <https://docs.dwservice.net/docs/site/developer/>.
* Sem Instalação: opção de agente portátil disponível no download.

Para mais detalhes, consulte a documentação oficial: <https://docs.dwservice.net/docs/site/dwservice-installation/how-do-i-install-the-agent/>.

Este manual é baseado na documentação oficial do DWService (versão atual em outubro de 2025). Atualize conforme novas versões. Se precisar de suporte, contate a equipe via site.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://suportech.gitbook.io/suportech-docs/suportech-r-ferramentas-help-desk/instalacao-sptremote/instalacao-do-dwagent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.