> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.medemerge.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalar o coletor

> Do repositório público ao primeiro envio, em quatro passos.

Antes de começar, confira os [requisitos](/coletor/requisitos) e tenha em mãos o `public_id` e o `agent_secret` enviados pela MedEmerge.

<Steps>
  <Step title="Baixe o pacote de instalação">
    O pacote fica no repositório público [MedEmerge/coletor](https://github.com/MedEmerge/coletor). Na máquina que tem acesso ao banco:

    ```bash theme={null}
    git clone https://github.com/MedEmerge/coletor.git
    cd coletor
    cp credentials.example.yaml credentials.yaml
    ```

    O pacote não tem código-fonte: são três arquivos, o `docker-compose.yml`, o exemplo de credenciais e um README.
  </Step>

  <Step title="Preencha a identidade do agente">
    Edite o `credentials.yaml` com os dois valores recebidos:

    ```yaml credentials.yaml theme={null}
    public_id: '...'
    agent_secret: '...'
    ```

    Só isso. Consultas, intervalos e credenciais do banco vêm do servidor.
  </Step>

  <Step title="Suba o coletor">
    ```bash theme={null}
    docker compose up -d
    ```

    O Docker baixa a imagem `ghcr.io/medemerge/coletor` na versão fixada no `docker-compose.yml` e inicia o agente.
  </Step>

  <Step title="Confirme o primeiro envio">
    ```bash theme={null}
    docker compose logs -f
    ```

    O esperado, em até um minuto:

    ```text theme={null}
    config vN recebida
    query ... coletada
    lote ... enviado
    ```

    Avise a MedEmerge que o agente subiu. Do lado da plataforma, o suporte confirma que os dados estão chegando.
  </Step>
</Steps>

Se alguma mensagem de erro aparecer no lugar dessas, veja [Diagnóstico](/coletor/diagnostico).

## O que fica nesta máquina

* O `credentials.yaml`, com a identidade do agente. Ele é montado no container como somente leitura.
* Um volume do Docker com o buffer de reenvio, que sobrevive a restart e a atualização.
* Os logs do container, com rotação automática: até três arquivos de 10 MB.

A senha do banco **não** fica em disco: o coletor a recebe do servidor e a mantém só em memória.

<Tip>
  Guarde o `credentials.yaml` como qualquer outra credencial: legível apenas para quem administra a
  máquina. Se ele vazar, peça à MedEmerge um novo `agent_secret`; o anterior deixa de funcionar na
  hora.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.