Problemas na Inicialização

Erro de Montagem de Volume no WSL

Sintoma. Ao executar docker compose up -d, ocorre um erro:

Error response from daemon: error while mounting volume '/var/lib/docker/volumes/proxy_proxy_configs/_data': 
failed to mount local volume: mount /run/desktop/mnt/host/wsl/docker-desktop-bind-mounts/Ubuntu/...
: no such file or directory

Solução.

É possível excluir um volume somente após a exclusão dos contêineres aos quais ele está montado. Os dados de monitoramento (Grafana, Prometheus) são preservados.

1. No Docker Desktop, vá para a seção Containers e abra o projeto proxy.
2. Exclua os contêineres hashcore-stratum-proxy e hashcore-proxy-configurator.
3. Vá para a seção Volumes e exclua proxy_proxy_configs.
4. Reinicie o WSL (no PowerShell como administrador):

   wsl --shutdown
   

5. Aguarde até que o Docker Engine seja reiniciado e o status mude para "Engine running".
6. Inicie todos os serviços novamente — o Docker recriará os contêineres e o volume automaticamente:

   docker compose up -d
   

7. Certifique-se de que todos os contêineres estejam em execução:

   docker ps
   

Conflitos de Portas

Sintoma. Os contêineres não iniciam, e os logs mostram uma mensagem de que a porta já está em uso.

Solução. Altere as portas ocupadas no arquivo docker-compose.yml.

⚠️ As portas são especificadas no formato "PORTA_EXTERNA:PORTA_INTERNA". Altere apenas o valor esquerdo (a porta disponível no seu PC). O valor direito (porta interna do contêiner) não pode ser alterado.

Exemplos de substituição correta:

• Configurador: 5001:5001 → 5002:5001 (alteramos apenas a parte esquerda)
• Grafana: 5000:3000 → 5050:3000 (a porta interna 3000 permanece inalterada)
• Proxy API: 5010:5010 → 5020:5010

Problemas de Permissões (Linux)

Sintoma. O Docker não inicia devido a problemas de permissões.

Solução. Adicione o usuário atual ao grupo docker:

sudo usermod -aG docker $USER

Após executar o comando, faça logout e login novamente para que as alterações entrem em vigor.

Monitoramento não funciona após atualização

Sintoma. Após executar docker compose pull, Grafana ou Prometheus não iniciam ou exibem erros.

Causa. Ao atualizar os serviços para uma nova versão principal, o formato de armazenamento de dados nos volumes pode mudar e se tornar incompatível com os dados de monitoramento acumulados anteriormente.

Solução A — excluir dados de monitoramento (os dados serão perdidos):

1. Abra o Docker Desktop.
2. Vá para a seção Containers e encontre o projeto proxy.
3. Exclua os contêineres grafana e prometheus.

⚠️ Este passo excluirá todos os dados de monitoramento acumulados de forma irreversível. Se os dados forem importantes, faça um backup dos volumes primeiro.

4. Vá para a seção Volumes e exclua:

• proxy_grafana_data
• proxy_prometheus_data

5. No terminal, execute:

   docker compose up -d
   

O sistema recriará os volumes e iniciará o monitoramento com dados limpos.

Solução B — fixar as versões das imagens (os dados serão preservados):

Para que esta situação não se repita na próxima atualização, fixe as versões das imagens no docker-compose.yml. Consulte a seção 3.4 para mais detalhes.

Se o problema persistir após a Solução A, entre em contato com o suporte.