Esta e a parte que coloca a Hotwallets para funcionar.
Quando essa etapa termina com sucesso, normalmente voce ja consegue:
- acessar o painel administrativo;
- confirmar que os servicos principais subiram;
- validar que a plataforma ficou disponivel no seu ambiente.
O que existe dentro do ambiente principal
Voce nao precisa subir servico por servico manualmente, mas ajuda saber o papel de cada grupo:
- o frontend admin mostra a interface do sistema;
- a API recebe comandos e consultas;
- o banco guarda os dados;
- o message broker ajuda os componentes a trocarem informacoes internas;
- os componentes de signer participam do processamento de operacoes mais sensiveis.
Em outras palavras, essa primeira etapa monta a base operacional da plataforma.
Baixar e preparar os arquivos
Baixe os arquivos da instalacao principal da Hotwallets. Voce pode usar o repositorio oficial no GitHub ou baixar o ZIP pronto.
git clone https://github.com/hotwalletsbr/hotwallets-selfhost.git
cd hotwallets-selfhost
bash ./setup-selfhost.sh
Se preferir baixar o ZIP:
https://github.com/hotwalletsbr/hotwallets-selfhost/archive/refs/heads/main.zip
Depois de extrair o arquivo, entre na pasta hotwallets-selfhost-main e execute:
bash ./setup-selfhost.sh
O que esse passo faz
O setup-selfhost.sh prepara o ambiente antes da subida real dos servicos.
Na pratica, ele serve para:
- coletar as configuracoes basicas;
- registrar imagens e enderecos necessarios;
- deixar o ambiente pronto para o comando que sobe a plataforma.
Pense nesse script como o momento de configuracao inicial da instalacao.
Valores padrao do instalador
Se voce nao precisar de configuracao customizada, normalmente pode apenas pressionar Enter para aceitar os valores sugeridos.
- as imagens padrao apontam para os repositorios oficiais da Hotwallets com a tag
latest; - o RabbitMQ usa por padrao
amqp://guest:guest@message-broker:5672; - o banco do signer usa por padrao
postgres://postgres:postgres@backend-signer-db:5432/worker_signer; - o banco da API usa por padrao
postgres://postgres:postgres@backend-api-db:5432/client_api; - as portas padrao sao
3001para o frontend admin,3100para a API e3000para o websocket do signer.
Explicando esses valores para quem nao e tecnico
- Imagem: e o pacote pronto de um servico que o Docker vai executar.
- RabbitMQ: e o componente usado para troca de mensagens internas entre servicos.
- Postgres: e o banco de dados.
- Porta: e o numero usado pela maquina para expor um servico.
Voce nao precisa decorar essas informacoes. O importante e saber que elas definem como os componentes se encontram e se comunicam.
Subir os servicos principais
Depois da configuracao inicial, execute o comando abaixo para ligar o ambiente principal:
cd <pasta-do-hotwallets-selfhost>
bash ./start-selfhost.sh
O que esse comando faz
Esse e o comando que realmente sobe o sistema.
Durante essa etapa:
- as imagens necessarias podem ser baixadas;
- os containers dos servicos principais sao iniciados;
- o ambiente passa a ficar disponivel para acesso e validacao;
- em alguns casos, pode haver criacao do usuario administrador inicial.
Se voce quiser uma analogia simples, o setup prepara o terreno e o start liga a operacao.
Como saber se deu certo
Considere a etapa concluida quando:
- o script termina sem erro;
- a saida informa que o ambiente esta no ar;
- o endereco do painel administrativo e mostrado;
- o painel abre normalmente no navegador.
Se algo der errado nesta fase
Os problemas mais comuns aqui costumam ser:
- Docker ou Docker Compose nao estao funcionando;
- alguma configuracao foi preenchida incorretamente;
- os arquivos ou imagens de instalacao nao correspondem ao ambiente esperado.
Se ocorrer erro, nao tente pular para a etapa seguinte. Primeiro resolva a subida do ambiente principal.