> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/guias-de-instalacao/instalacao-do-weknow-client.md).

# Instalação do Weknow Client

O **Weknow Client** é a aplicação utilizada por desenvolvedores e analistas para criar e manter dashboards, indicadores, metadados, fórmulas e demais recursos da plataforma.

Embora o **Weknow Client** possa ser instalado na mesma máquina do **Weknow Server** para fins de desenvolvimento, homologação ou testes, recomenda-se que cada desenvolvedor utilize uma estação de trabalho dedicada, proporcionando melhor desempenho, isolamento entre os ambientes e maior facilidade de manutenção.

#### 1. Pré-requisitos

Antes de iniciar a instalação, verifique se a estação de trabalho atende aos requisitos mínimos descritos no artigo [Visão geral do Weknow Web](/wedocs-5.2/weknow-web/visao-geral-do-weknow-web.md).

Em seguida:

* Obtenha o instalador `wknw_client_installer.exe` fornecido pela equipe da Weknow.
* Execute o instalador com privilégios de administrador.

#### 2. Passo a passo da instalação

**Passo 1: Inicialização**

Execute o arquivo do instalador (`wknw_client_installer.exe`) como administrador.

Na tela inicial do assistente, clique em **Próximo**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F5m7bUixcktolbdGs8Xup%2F%5Bimagem%201%20-%20tela%20inicial%20do%20assistente%20de%20instala%C3%A7%C3%A3o%20do%20Weknow%20Cliente%5D.png?alt=media&amp;token=6e1a28f4-a917-4904-b8e0-de98d472536d" alt=""><figcaption></figcaption></figure>

**Passo 2: Diretórios de instalação**

Defina o diretório onde o Weknow Client será instalado.

Caso não exista necessidade específica, recomenda-se manter o diretório sugerido pelo instalador.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FiTekkFCUL8Cycm65zdrJ%2F%5Bimagem%203%20-%20defini%C3%A7%C3%A3o%20do%20diret%C3%B3rio%20de%20instala%C3%A7%C3%A3o%5D.png?alt=media&amp;token=3444d889-ef26-49d0-84af-95aa264bf492" alt=""><figcaption></figcaption></figure>

**Passo 3: Configuração da conexão com o Weknow Server**

Nesta etapa é realizada a configuração da conexão entre o Weknow Client e o Weknow Server.

<table><thead><tr><th width="374">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td>Endereço</td><td>IP ou nome DNS do servidor Weknow. Para instalações locais de desenvolvimento ou testes, em que o Weknow Client e o Weknow Server estejam instalados na mesma máquina, utilize <strong>localhost</strong> como endereço do servidor.</td></tr><tr><td>Porta</td><td>Porta configurada no Weknow Server (padrão: <strong>211</strong>).</td></tr><tr><td>Identificador da conta</td><td>Chave de identificação da conta cadastrada no servidor.</td></tr></tbody></table>

O **Identificador da Conta** é o código utilizado pelo Weknow Client para localizar e autenticar a conta configurada no Weknow Server.

Após realizar o teste de conexão, verifique se o instalador indica que a comunicação com o **Weknow Server** foi estabelecida com sucesso. Caso seja apresentada alguma mensagem de erro relacionada à conectividade, revise o endereço do servidor, a porta configurada, as regras de firewall e confirme se o **Weknow Server** está em execução antes de prosseguir com a instalação.

{% hint style="info" %}
**Importante:** A instalação permite configurar uma conexão inicial com o **Weknow Server**. Caso seja necessário acessar outros servidores posteriormente, novas conexões poderão ser adicionadas diretamente pelo **Weknow Client**.
{% endhint %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FkK64eyd3P4qCaN0hvCet%2Fimage.png?alt=media&amp;token=bdfb2031-fafa-4841-b909-16e1a28d3e16" alt=""><figcaption></figcaption></figure>

**Passo 5: Seleção do canal de atualização**

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FDZc1U07jztLGTOtDWOmv%2Fimage.png?alt=media&amp;token=c5d71186-722e-447d-a0dd-3ad5693c89ac" alt=""><figcaption></figcaption></figure>

| Opção              | Indicação                                             |
| ------------------ | ----------------------------------------------------- |
| **Versão estável** | Recomendada para ambientes de produção.               |
| **Versão beta**    | Indicada para homologação e testes de novos recursos. |

**Passo 6: Revisão e conclusão**

Revise as configurações selecionadas.

Se todas as informações estiverem corretas:

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FPsBenTW9ilq3Zv6sJFHZ%2Fimage.png?alt=media&amp;token=68ce1e00-cd0b-4de2-90e7-c10e8339a740" alt=""><figcaption></figcaption></figure>

1. Clique em **Instalar**.
2. Aguarde a conclusão da instalação.
3. Caso deseje iniciar o Weknow Client imediatamente, mantenha selecionada a opção **Executar o Cliente**.
4. Clique em **Terminar**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2F04bYFZa1l23bD7RvkswZ%2F%5Bimagem%206%20-%20tela%20de%20conclus%C3%A3o%20da%20instala%C3%A7%C3%A3o%5D.png?alt=media&amp;token=543ee14b-969c-4339-8019-a0a59a4839bc" alt=""><figcaption></figcaption></figure>

***

### 📑 Apêndice: Como localizar o Identificador da Conta

**Caso seja necessário instalar o Weknow Client em uma nova estação de trabalho**, o Identificador da Conta poderá ser obtido da seguinte forma:

1. Abra o **Weknow Server**.
2. Acesse o módulo **Contas**.
3. Localize a conta desejada.
4. Abra o cadastro da conta.
5. Copie o valor do campo **Identificador**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FAoEZxpTyP1n7to9HFIPg%2Fimage.png?alt=media&amp;token=364d8a77-5d48-4f17-aec3-fd5a4e031b4e" alt=""><figcaption></figcaption></figure>

1. Utilize esse código durante a configuração da conexão no **Passo 4** deste artigo.

***

### 📚 Próximos passos

Após concluir a instalação do Weknow Client, recomenda-se:

* validar a comunicação com o Weknow Server;
* acessar a plataforma utilizando um **usuário com permissões adequadas**;
* verificar se os dashboards são carregados corretamente;
* prosseguir para os artigos do **Manual do contrutor:** [Broken mention](broken://pages/wSCohgny8x3Nk7PffDMW), onde são apresentados os recursos de criação, configuração e manutenção de dashboards, metadados, componentes visuais, filtros e demais funcionalidades da plataforma.