Nenhuma VPS cadastrada. Cadastre uma na aba VPS.

Cadastrar VPS e preparar instalação

Informe o nome e o IP público fixo da VPS. O comando passa esse IP ao instalador pela flag --ip; o agente também o envia junto com o token ao conectar. A API compara o IP declarado com o cadastro, sem depender do IP que o proxy Docker/LiteSpeed enxerga. O instalador detecta arquitetura e distribuição Linux e baixa o binário compatível.

Distribuição e versão do Linux aparecem automaticamente depois que o agente envia a primeira leitura. A arquitetura do binário também é detectada pelo instalador.

Nenhuma VPS cadastrada.

Após publicar, agentes compatíveis em modo contínuo baixam a versão automaticamente na próxima verificação. Isso pode levar até uma hora.

Nenhuma versão publicada.

Instalação automática (recomendada)

Na aba VPS, cadastre nome e IP público, copie o comando e execute-o em Bash na VPS. Cole o token quando o terminal pedir. O instalador confere o IP, detecta amd64 ou arm64, baixa o binário correto, configura o acesso e ativa o serviço para iniciar junto com o sistema.

Não é preciso escolher Ubuntu/Debian ou a versão da distribuição para instalar. O agente lê essa informação automaticamente. No Dashboard, cada projeto de /home/docker com containers associados pelo Docker Compose ganha uma aba própria. Projetos sem containers não aparecem como abas. Para cada container ativo, identifica runtimes como PHP e Node e coleta CPU, RAM e armazenamento. O instalador identifica o grupo do socket Docker e adiciona o agente a ele. Esse grupo dá controle amplo sobre o Docker e equivale, na prática, a acesso root na VPS.

Em VPS já instaladas, atualizar o binário não altera a unidade systemd. Para liberar o Docker, adicione o usuário do agente ao grupo do socket:

docker_group=$(stat -c '%G' /var/run/docker.sock)
sudo usermod -aG "$docker_group" vibe-monitor
sudo systemctl restart vibe-monitor
sudo -u vibe-monitor docker ps -a

O último comando deve listar os containers. Se stat mostrar root, o socket não tem um grupo Docker dedicado e precisa ser configurado pelo administrador.

Para as abas de projetos, a unidade antiga também precisa liberar a leitura de /home/docker, que antes ficava oculta. Aplique este override uma única vez:

sudo systemctl edit vibe-monitor

Adicione no editor:

[Service]
ProtectHome=tmpfs
BindReadOnlyPaths=/home/docker

Salve e aplique:

sudo systemctl daemon-reload
sudo systemctl restart vibe-monitor

Instalação manual (alternativa)

1. Publique primeiro uma versão para a arquitetura da VPS na aba Publicar versão.
2. Na aba Histórico, baixe o binário correspondente e envie-o à VPS.
3. Na VPS, torne-o executável e abra o menu interativo:

chmod 0755 vibe-monitor
./vibe-monitor

No menu, escolha Configurar servidor e token, aceite o endereço padrão e cole o token daquela VPS. Para um teste rápido, escolha Enviar uma leitura agora. Para deixar rodando em segundo plano e iniciar automaticamente junto com a VPS, instale como serviço systemd abaixo.

Rodar em segundo plano e iniciar com a VPS

Os comandos a seguir presumem que o binário baixado está na pasta atual da VPS. Eles criam um usuário restrito, configuram o token e registram um serviço que inicia no boot e reinicia o agente após falhas.

sudo useradd --system --no-create-home --home-dir /var/lib/vibe-monitor --shell /usr/sbin/nologin vibe-monitor
sudo install -d -m 0700 -o vibe-monitor -g vibe-monitor /var/lib/vibe-monitor
sudo install -m 0755 -o vibe-monitor -g vibe-monitor ./vibe-monitor /var/lib/vibe-monitor/vibe-monitor
sudo -u vibe-monitor /var/lib/vibe-monitor/vibe-monitor -config /var/lib/vibe-monitor/config.json setup
sudo -u vibe-monitor /var/lib/vibe-monitor/vibe-monitor -config /var/lib/vibe-monitor/config.json once

No comando setup, pressione Enter para aceitar o servidor padrão e cole o token. O comando once confirma que a credencial funciona antes de ativar o serviço.

Para consultar containers, o usuário do agente precisa pertencer ao grupo do socket Docker. O instalador automático detecta esse grupo:

docker_group=$(stat -c '%G' /var/run/docker.sock)
docker_group_line=''
if [ -n "$docker_group" ] && [ "$docker_group" != root ] && getent group "$docker_group" >/dev/null; then
  sudo usermod -aG "$docker_group" vibe-monitor
  docker_group_line="SupplementaryGroups=$docker_group"
fi
sudo tee /etc/systemd/system/vibe-monitor.service > /dev/null <<UNIT
[Unit]
Description=Vibe Monitor VPS agent
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=vibe-monitor
Group=vibe-monitor
$docker_group_line
StateDirectory=vibe-monitor
StateDirectoryMode=0700
ExecStart=/var/lib/vibe-monitor/vibe-monitor -config /var/lib/vibe-monitor/config.json run
Restart=on-failure
RestartSec=10
RestartPreventExitStatus=2
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=tmpfs
BindReadOnlyPaths=/home/docker
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
sudo systemctl daemon-reload
sudo systemctl enable --now vibe-monitor

enable --now inicia agora e configura a inicialização automática no próximo boot. Consulte com sudo systemctl status vibe-monitor e veja os logs com sudo journalctl -fu vibe-monitor.

Atualizações automáticas

O agente atualiza enquanto estiver rodando em modo contínuo (run ou systemd). Após enviar uma leitura com sucesso, consulta novas versões e verifica novamente a cada hora. A versão publicada precisa ser maior e corresponder à arquitetura da VPS. O comando once envia uma leitura e termina, portanto não atualiza.

O agente também consulta atualizações do Linux a cada hora usando o índice local do gerenciador de pacotes (apt, dnf, yum ou apk). O Dashboard mostra os pacotes, as versões disponíveis e atualizações relacionadas ao kernel. A consulta não instala nem baixa pacotes.

Trocar o token de autenticação da VPS

O token autentica uma VPS na API. Gere uma credencial nova com POST /v1/api/monitoring/agents, autenticado como administrador e enviando {"name":"nome-da-vps","allowed_ip":"IP_PUBLICO"}. Guarde o token retornado; a API só o mostra na criação. Isso cadastra um novo agente. Depois de validar a conexão com o token novo, revogue o agente antigo com DELETE /v1/api/monitoring/agents/{id}. O comando setup grava o token e o IP cadastrado; não gera tokens.

Agente iniciado no terminal

./vibe-monitor setup

Pressione Enter para manter o endereço padrão, cole o token novo e informe o IP cadastrado. Depois valide com ./vibe-monitor once e inicie novamente com ./vibe-monitor run.

Agente rodando como serviço systemd

sudo systemctl stop vibe-monitor
sudo -u vibe-monitor /var/lib/vibe-monitor/vibe-monitor -config /var/lib/vibe-monitor/config.json setup
sudo -u vibe-monitor /var/lib/vibe-monitor/vibe-monitor -config /var/lib/vibe-monitor/config.json once
sudo systemctl start vibe-monitor

O comando pede o endereço e o token novo. Pressione Enter no endereço para mantê-lo. Depois de validar a conexão, o serviço volta a monitorar.

Nota: esse token da VPS é diferente da chave pública de assinatura incluída no comando de compilação. Trocar a chave de assinatura exige recompilar e substituir manualmente os binários já instalados para que confiem na nova chave.

Comandos úteis na VPS

• ./vibe-monitor run monitorar continuamente e aplicar atualizações
• ./vibe-monitor status conferir a conexão e a última leitura
• ./vibe-monitor services listar os serviços detectados
• ./vibe-monitor version mostrar a versão instalada