Ambiente principal

Esta etapa coloca a Hotwallets em funcionamento no ambiente principal.

O que esta etapa entrega

Quando esta etapa termina com sucesso, o esperado e:

• os servicos principais estarem iniciados;
• o painel administrativo estar acessivel;
• a plataforma responder no ambiente configurado.

Antes de executar

Antes de rodar qualquer comando, confirme:

• Docker e Docker Compose estao instalados e funcionando;
• o pacote ou repositorio da instalacao principal foi recebido;
• voce esta no host correto onde o ambiente principal sera executado;
• ha permissao para baixar imagens e iniciar containers.

Baixar e preparar os arquivos

Voce pode usar o repositorio oficial no GitHub ou um pacote ZIP fornecido.

Opcao 1: clonar o repositorio

git clone https://github.com/hotwalletsbr/hotwallets-selfhost.git
cd hotwallets-selfhost
bash ./setup-selfhost.sh

Opcao 2: usar o ZIP

Arquivo:

https://github.com/hotwalletsbr/hotwallets-selfhost/archive/refs/heads/main.zip

Depois de extrair o ZIP:

cd hotwallets-selfhost-main
bash ./setup-selfhost.sh

O que o setup faz

O setup-selfhost.sh prepara o ambiente antes da subida real dos servicos.

Esse script:

• coleta as configuracoes basicas;
• registra imagens e enderecos necessarios;
• prepara o ambiente para o comando de inicializacao.

Valores padrao do instalador

Se nao houver necessidade de customizacao, os valores sugeridos podem ser mantidos.

Valores padrao mencionados pelo instalador:

• imagens da Hotwallets com tag latest;
• RabbitMQ: amqp://guest:guest@message-broker:5672;
• banco do signer: postgres://postgres:postgres@backend-signer-db:5432/worker_signer;
• banco da API: postgres://postgres:postgres@backend-api-db:5432/client_api;
• portas: 3001 para frontend admin, 3100 para API e 3000 para websocket do signer.

Significado dos termos mais usados

• Imagem Pacote usado pelo Docker para executar um servico.
• RabbitMQ Componente de mensageria entre servicos internos.
• Postgres Banco de dados.
• Porta Numero pelo qual um servico fica acessivel na maquina.

Subir os servicos principais

Depois do setup, execute:

cd <pasta-do-hotwallets-selfhost>
bash ./start-selfhost.sh

O que o start faz

O start-selfhost.sh inicia os servicos da plataforma.

Durante essa etapa:

• as imagens necessarias podem ser baixadas;
• os containers sao iniciados;
• o ambiente passa a ficar disponivel para acesso;
• o usuario administrador inicial pode ser criado, dependendo da configuracao.

Resultado esperado

Considere a etapa concluida quando:

• o script termina sem erro;
• os servicos sobem sem falha imediata;
• o terminal informa que o ambiente esta ativo;
• o endereco do painel administrativo e exibido;
• o painel abre no navegador.

Sinais de problema

Pare e revise a etapa se acontecer algum dos casos abaixo:

• Docker ou Docker Compose nao iniciam;
• o script termina com erro;
• imagens nao sao baixadas;
• containers entram em falha logo apos iniciar;
• o painel administrativo nao abre.

O que revisar se der erro

Os problemas mais comuns nesta fase sao:

• Docker ou Docker Compose indisponiveis;
• configuracao preenchida de forma incorreta;
• arquivos de instalacao incompletos ou divergentes do ambiente esperado;
• falta de acesso de rede para baixar imagens.

Resolva essa etapa antes de seguir para a instalacao do cosigner.