Orbivm Baixar o appliance

Documentação

Instalação, primeiro acesso, rede, atualização e uso do Orbivm.

Requisitos

ItemMínimo
Hipervisor do applianceVMware ESXi 6.5 ou mais novo (também VirtualBox e Oracle VM)
VM2 vCPU, 4 GiB de memória, disco de 40 GiB thin
RedeUma placa com DHCP ou IP fixo; HTTPS (443) até os hosts ESXi e vCenter que serão gerenciados
NavegadorChrome, Edge, Firefox ou Safari atualizados
Hosts gerenciadosESXi 6.5 a 9.x e vCenter Server; Proxmox VE e KVM para conversão

Instalar o appliance

  1. Baixe o arquivo Orbivm-<versão>.ova em Download.
  2. No ESXi Host Client: Criar/registrar VM › Implantar uma máquina virtual de um arquivo OVF ou OVA.
  3. Dê um nome à VM, escolha o arquivo, o datastore e a rede, e conclua.
  4. Ligue a VM. O primeiro boot leva de 2 a 5 minutos: o Orbivm gera senhas e chaves únicas para esta instalação, carrega os serviços e sobe em HTTPS.

Primeiro acesso e credenciais

Abra o console da VM no ESXi. A tela mostra o endereço de acesso e a senha inicial.

AcessoUsuárioSenha
Console web https://<ip>suporteGerada no primeiro boot. Aparece no console da VM e fica em /root/orbivm-acesso.txt
Sistema (console da VM e SSH)orbivmorbivm, com troca obrigatória no primeiro login
Cada appliance tem senhas próprias: duas VMs importadas do mesmo OVA nunca compartilham credenciais. Troque a senha da web em Perfil no primeiro acesso. A conta root vem bloqueada; use o usuário orbivm com sudo.

O certificado inicial é autoassinado, e o navegador avisa no primeiro acesso. Troque por um certificado da sua CA ou do próprio Orbivm (veja Certificados).

Esqueceu a senha da web? Com o e-mail (SMTP) configurado, use Esqueci minha senha no login. Sem e-mail, entre no console da VM como orbivm e redefina:

cd /opt/orbivm && sudo docker compose --env-file .ports.env exec api python cli.py reset-password suporte

Rede e IP fixo

O appliance usa DHCP. Para IP fixo, entre no console da VM como orbivm e rode:

sudo orbivm-rede

Informe IP com máscara (ex.: 10.0.10.50/24), gateway e DNS. O Orbivm ajusta o endereço público e gera um certificado para o novo IP.

Chave de atualização

As atualizações vêm de um registro privado. Depois do primeiro boot, entre no console da VM como orbivm e informe a chave recebida com a licença:

sudo orbivm-chave

Com a chave configurada, Administração › Atualizações mostra e aplica as versões novas.

Instalar com Docker

Em um Linux com Docker 24+ e Compose v2:

git clone https://github.com/lexlam-tech/orbivm.git orbivm && cd orbivm
./service-start configure --production --hostname orbivm.suaempresa.com.br
./service-start

O comando mostra o endereço e a senha inicial do usuário suporte. Coloque o certificado da empresa em certs/tls.crt e certs/tls.key, ou deixe o Orbivm gerar um autoassinado.

Cadastrar hosts

  1. Em Inventário › Hosts e conexões, clique em Adicionar.
  2. Informe o endereço do ESXi ou vCenter, a porta (443), o usuário e a senha. Para só consultar, uma conta somente leitura basta; para patch, backup e manutenção, use uma conta administrativa.
  3. Clique em Consultar agora. Inventário, CVEs, diagnóstico e certificados aparecem em seguida.

Atualizar o Orbivm

O Orbivm verifica a cada 6 horas se há versão nova e avisa no sino e nos canais configurados (e-mail, Slack, Teams, Telegram). Para atualizar:

  1. Abra Administração › Atualizações e veja a versão disponível e as novidades.
  2. Clique em Atualizar agora. O Orbivm confere a assinatura digital da versão, faz backup do banco, baixa as imagens novas e reinicia os serviços (cerca de 1 minuto).
  3. Se a versão nova não subir saudável, o Orbivm volta sozinho para a anterior.
Versões sem assinatura válida são recusadas. O backup do banco de cada atualização fica em /opt/orbivm/backups.

Backup de VMs

Em Proteção › Backup de VMs:

  1. Cadastre um repositório: datastore do host, NFS do NAS (o Orbivm monta no ESXi) ou bucket S3 (iDrive e2, Wasabi, Amazon S3, Backblaze B2, MinIO, Cloudflare R2).
  2. Crie uma política: VMs, destino, dias, horário e quantas cópias manter.
  3. Para restaurar, escolha o ponto de restauração: completa (copia e registra) ou instantânea (roda direto do backup, para datastore e NFS).

As VMs continuam ligadas: o Orbivm usa um snapshot temporário, com quiesce quando o VMware Tools está ativo. A VM restaurada entra com nome e identidade novos, sem tocar na original.

Conversão e appliances

Em Proteção › Conversão e appliances, converta VMs entre VMware, Proxmox e KVM nos dois sentidos, ou gere um appliance OVA, QCOW2, VMDK, VHDX (Hyper-V) ou RAW. Proxmox e KVM são cadastrados com acesso SSH. A VM de origem nunca é alterada.

Certificados

Na página do host, botão Certificado: confie na CA corporativa que o host já usa, emita pela CA do Orbivm em um clique, renove pela VMCA do vCenter ou instale um certificado da CA da empresa a partir do CSR. O Orbivm avisa 60 dias antes do vencimento e renova sozinho os certificados da própria CA.

Segurança do appliance

Suporte

Escreva para [email protected] com a versão (rodapé da console) e o que aconteceu. O manual completo também está dentro do produto, em Manual.