A condição principal é ter uma porta única e livre

• 1. Criar uma nova pasta para o bot (no exemplo, pasta hb1). Assim, você pode instalar vários bots em pastas diferentes hb1, hb2...:
  mkdir -p /opt/hb1
• 2. Entrar na pasta criada:
  cd /opt/hb1
• 3. Baixar e executar o script install_local.sh:
  wget -qO- https://raw.githubusercontent.com/ksandric/hamster-bot/refs/heads/master/install_local.sh | bash
  Este comando baixa o arquivo install_local.sh e executa. (o script baixa → descompacta o zip e cria o .service no systemd)
• 4. Durante o processo, o script solicitará a porta e verificará se ela está livre

Pronto! O bot foi instalado na pasta hb4 e será iniciado o serviço com o mesmo nome hb4.serviece.
No terminal, você verá o log do bot em tempo real. Pode prosseguir para adicionar chaves API e configurar estratégias.

Quando há 2 ou mais bots no seu VPS:
/opt/hb1
/opt/hb2
/opt/hb3

Para atualizar o bot no diretório /opt/hb2, execute os comandos abaixo em sequência:

• 1. Entrar no diretório correto (no exemplo, pasta hb2):
  cd /opt/hb2
• 2. Baixar e executar o script update_local.sh:
  wget -qO- https://raw.githubusercontent.com/ksandric/hamster-bot/refs/heads/master/update_local.sh | bash

Pronto! O bot será atualizado e reiniciado somente na pasta /hb2. O script encontra automaticamente o serviço associado à pasta escolhida.

Se no seu VPS Linux foram instalados muitos bots diferentes e você não consegue identificar qual .service pertence a qual pasta, recomendo usar o comando:
grep -rl "hb_c" /usr/lib/systemd/system/

Esse comando lista todos os serviços que contêm o executável hb_c (o executável do bot). Assim, você pode encontrar o serviço correto e saber a qual pasta ele pertence.

Na imagem vemos 5 serviços, mas na pasta há apenas (2) bots — então há serviços extras.

Se você usar o nome do diretório como termo de busca, será exibida a lista de serviços que apontam para essa pasta:
grep -rl "/hb/" /usr/lib/systemd/system/

Se quiser remover o serviço do bot, execute:
1. systemctl stop hb2.service - parar o serviço hb2
2. systemctl disable hb2.service - desativar o serviço hb2
3. rm -rf /usr/lib/systemd/system/hb2.service - remover o arquivo de serviço hb2.service

Link do vídeo: youtu.be/jxb6aZQwtN4

Primeiro, conecte-se ao VPS via SSH usando termius (ou putty)

• Criar a pasta do bot (no exemplo, nome "hb")
  mkdir -p /opt/hb
• Entrar no diretório
  cd /opt/hb
• Baixar o arquivo zip
  wget https://github.com/ksandric/hamster-bot/blob/master/hb_linux-x64.zip?raw=true
• Se o unzip não estiver instalado, instalar
  sudo apt install unzip
• Descompactar o arquivo
  unzip hb_linux-x64.zip?raw=true
• Remover o zip
  rm -rf hb_linux-x64.zip?raw=true
• Dar permissão de execução ao arquivo (o executável é o hb_c)
  chmod +x ./hb_c

Depois disso, você pode executar o arquivo com ./hb_c, mas isso não é ideal. É necessário criar um serviço para que o bot rode em segundo plano e não pare ao fechar o terminal.

• Entrar no diretório
  cd /usr/lib/systemd/system/
• Criar o arquivo hamster-bot_1.service. Você pode criar com:
  nano hamster-bot_1.service
  (o nome pode ser qualquer, a extensão é sempre .service. Assim é possível criar vários serviços, mas certifique-se de usar portas diferentes no config dos bots)

Conteúdo do arquivo: hamster-bot_1.service
[Unit]
Description=hamster-bot_1
After=multi-user.target
[Service]
Environment="DOTNET_BUNDLE_EXTRACT_BASE_DIR=%h/.net"
Type=simple
ExecStart=/opt/hb/hb_c
WorkingDirectory=/opt/hb
RestartSec=61
Restart=always
[Install]
WantedBy=multi-user.target


• Salvar as mudanças e fechar o arquivo Ctrl+x, depois pressione Y e Enter
• Executar os comandos:
• systemctl daemon-reload
• systemctl enable hamster-bot_1.service
• apt-get update
• apt-get install -y libfreetype6
• apt-get install -y libfontconfig1
• apt-get install -y fontconfig
• sudo timedatectl set-timezone UTC
• Дополнительно можно установить fail2ban:
  apt-get install fail2ban
• Para abrir a porta onde o bot roda e deixar a interface web доступна pelo IP do servidor (no exemplo, porta 80):
• iptables -I INPUT -p tcp --dport 80 -j ACCEPT
• ufw allow 80
• Para iniciar o serviço, execute:
  systemctl start hamster-bot_1.service
• Pronto! O serviço já está disponível e iniciará automaticamente com o servidor (+ reinício automático se parar). Para управлять o serviço:
• Ver o log em tempo real: journalctl --follow -u hamster-bot_1.service
• Ver o status: systemctl status hamster-bot_1.service
• Parar: systemctl stop hamster-bot_1.service
• Desativar: systemctl disable hamster-bot_1.service
• Reiniciar: systemctl restart hamster-bot_1.service
• Após iniciar, para ler o log do bot em tempo real:
• Entrar na pasta cd /opt/hb/logs
• Abrir o log tail -f log_тут_дата_лога.log (log geral + logs por estratégia)

Link do vídeo: youtu.be/FJgu7OfgUWU

Primeiro, conecte-se ao VPS via SSH usando o termius (ou putty)

No exemplo, o serviço se chama: "hamster-bot_1.service".
A pasta onde estão os arquivos do bot: "/opt/hb"

1. Parar o bot (parar o serviço)
   systemctl stop hamster-bot_1.service
2. Entrar na pasta do bot
   cd /opt/hb
3. Baixar o zip
   wget https://github.com/ksandric/hamster-bot/blob/master/hb_linux-x64.zip?raw=true
4. Descompactar substituindo arquivos (o arquivo settings_program.json será ignorado)
   unzip -u hb_linux-x64.zip?raw=true -x settings_program.json
5. Remover o zip
   rm -rf hb_linux-x64.zip?raw=true
6. Dar permissão de execução novamente
   chmod +x ./hb_c
7. Iniciar o bot
   systemctl restart hamster-bot_1.service
8. Pronto! O bot continuará funcionando com suas configurações. Tudo é feito sem fechar posições ou ordens