> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/primeiros-passos/instalacao-do-digitalsac-digicrm.md).

# 🛠️Instalação do DigitalSac DigiCRM

***

### 1. Acessar o painel do cliente

Após fazer login na área do cliente, acesse o menu superior:

**Serviços > DigitalSac** DigiCRM

Também é possível acessar pelo atalho lateral, caso esteja disponível:

**Portainer Services**

<figure><img src="/files/63DSFPzw8nElSliHgoY3" alt=""><figcaption></figcaption></figure>

***

### 2. Abrir o painel de instalações

Na tela **DigitalSac** DigiCRM, você verá o painel de gerenciamento das instalações.

Nesta área é possível:

* cadastrar novas instalações;
* visualizar instalações existentes;
* acompanhar o status da instalação;
* visualizar logs;
* reinstalar;
* editar;
* excluir uma instalação.

Para cadastrar uma nova instalação, clique em:

**+ Adicionar Instalação**

***

### 3. Adicionar uma nova instalação

Ao clicar em **+ Adicionar Instalação**, será aberta a janela de cadastro.

Informe primeiro o nome da instalação.

Exemplo:

**VPS Cliente X — Produção**

Use um nome fácil de identificar, principalmente se você gerencia várias instalações.<br>

<figure><img src="/files/2DIJH6NCtG2SoHTvhb7o" alt=""><figcaption></figcaption></figure>

***

### 4. Configurar o acesso SSH

Na seção **Acesso SSH**, informe os dados do servidor onde o sistema será instalado.

Campos obrigatórios:

| Campo          | Descrição                     |
| -------------- | ----------------------------- |
| IP do Servidor | IP público da VPS ou servidor |
| Usuário        | Usuário SSH do servidor       |
| Porta SSH      | Porta de acesso SSH           |

Exemplo:

| Campo          | Exemplo         |
| -------------- | --------------- |
| IP do Servidor | 123.123.123.123 |
| Usuário        | root            |
| Porta SSH      | 22              |

### 5. Configurar os domínios

Na seção **Domínios**, informe os domínios que serão utilizados pela instalação.

Campos principais:

| Campo                     | Descrição                             |
| ------------------------- | ------------------------------------- |
| Domínio Base / Licenciado | Domínio principal vinculado à licença |
| E-mail SSL Let's Encrypt  | E-mail usado para emissão do SSL      |
| Backend                   | Domínio da API/backend                |
| Frontend App              | Domínio do painel/app                 |
| Portainer                 | Domínio do Portainer                  |

Exemplo:

| Campo        | Exemplo                |
| ------------ | ---------------------- |
| Domínio Base | empresa.com.br         |
| E-mail SSL   | <admin@empresa.com.br> |
| Backend      | back.empresa.com.br    |
| Frontend App | app.empresa.com.br     |
| Portainer    | painel.empresa.com.br  |

Antes de instalar, todos os domínios precisam apontar para o IP do servidor.

Você pode usar o botão:

**Checar publicação DNS**

para validar se os domínios já estão publicados corretamente.

{% hint style="warning" %}
Se os domínios não estiverem apontando corretamente para o IP do servidor, a instalação pode falhar na etapa de SSL ou configuração do Traefik.
{% endhint %}

### 6. Configurar a licença

Na seção **Licença**, informe os dados da licença vinculada à instalação.

Campos:

| Campo           | Descrição                           |
| --------------- | ----------------------------------- |
| Token Company   | Token da empresa/licença            |
| Token Usuário   | Token do usuário                    |
| Tipo de Licença | Plano ou tipo de licença contratado |

Exemplo:

| Campo           | Exemplo                     |
| --------------- | --------------------------- |
| Token Company   | seu\_token\_company         |
| Token Usuário   | seu\_token\_usuario         |
| Tipo de Licença | Premium = Community Edition |

### 7. Configurar as opções do sistema

Na seção **Configurações**, revise as informações da aplicação.

Campos comuns:

| Campo             | Descrição                         |
| ----------------- | --------------------------------- |
| Nome da Instância | Nome interno da instalação        |
| Nome da Aplicação | Nome exibido no sistema           |
| Timezone          | Fuso horário da instalação        |
| Cache             | Configuração de cache             |
| Traefik           | Configuração do proxy/SSL         |
| PerfexCRM         | Integração opcional com PerfexCRM |

Exemplo:

| Campo             | Exemplo    |
| ----------------- | ---------- |
| Nome da Instância | DIGISAC    |
| Nome da Aplicação | DigitalSac |
| Timezone          | São Paulo  |

***

### 8. Salvar a instalação

Após preencher todos os campos, salve o cadastro.

A instalação será exibida no painel com as principais informações:

* nome da instalação;
* IP do servidor;
* domínios configurados;
* status;
* data de criação;
* botões de ação.

***

### 9. Executar a instalação

Depois de cadastrar a instalação, clique no botão:

**Instalar**

Caso a instalação já tenha sido executada anteriormente, o botão poderá aparecer como:

**Reinstalar**

Ao clicar, o sistema solicitará a senha SSH do servidor.

Informe a senha e confirme para iniciar a execução.\
![](/files/dGPB7oykR4DTnZ9JRNDo)

{% hint style="danger" %}
Confira os dados antes de iniciar. IP, domínios, tokens e porta SSH incorretos podem impedir a instalação.
{% endhint %}

### 10. Acompanhar os logs

Durante a instalação, clique em:

**Ver Log**

Nesta tela você poderá acompanhar o processo em tempo real.

O log ajuda a verificar:

* conexão SSH;
* criação dos arquivos;
* instalação de dependências;
* configuração dos containers;
* emissão de SSL;
* subida dos serviços;
* possíveis erros durante o processo.

{% hint style="info" %}
Se a instalação falhar, consulte primeiro o log. Ele normalmente indica exatamente em qual etapa ocorreu o problema.
{% endhint %}

### 11. Finalização da instalação

Quando a instalação for concluída corretamente, o status será exibido como:

**CONCLUÍDO**

Após isso, os links da instalação ficarão disponíveis no card.

Exemplo:

| Serviço   | URL                             |
| --------- | ------------------------------- |
| App       | <https://app.empresa.com.br>    |
| Backend   | <https://back.empresa.com.br>   |
| Portainer | <https://painel.empresa.com.br> |

***

### 12. Acessar o sistema

Clique no domínio do **Frontend App** para acessar o DigitalSac DigiCRM.

Depois disso, você poderá iniciar as configurações internas do sistema, como:

* usuários;
* filas;
* conexões;
* canais;
* permissões;
* integrações;
* configurações gerais.

***

### Checklist antes de instalar

Antes de clicar em **Instalar**, confira:

* O servidor está ativo.
* O IP do servidor está correto.
* O acesso SSH está funcionando.
* A porta SSH está correta.
* O usuário SSH tem permissão de administrador.
* Os domínios apontam para o IP do servidor.
* O e-mail SSL está correto.
* O Token Company está correto.
* O Token Usuário está correto.
* A licença está ativa.

{% hint style="success" %}
Com tudo preenchido corretamente, a instalação será executada automaticamente pelo painel.
{% endhint %}