Requisitos
| Item | Mínimo |
|---|---|
| Hipervisor do appliance | VMware ESXi 6.5 ou mais novo (também VirtualBox e Oracle VM) |
| VM | 2 vCPU, 4 GiB de memória, disco de 40 GiB thin |
| Rede | Uma placa com DHCP ou IP fixo; HTTPS (443) até os hosts ESXi e vCenter que serão gerenciados |
| Navegador | Chrome, Edge, Firefox ou Safari atualizados |
| Hosts gerenciados | ESXi 6.5 a 9.x e vCenter Server; Proxmox VE e KVM para conversão |
Instalar o appliance
- Baixe o arquivo
Orbivm-<versão>.ovaem Download. - No ESXi Host Client: Criar/registrar VM › Implantar uma máquina virtual de um arquivo OVF ou OVA.
- Dê um nome à VM, escolha o arquivo, o datastore e a rede, e conclua.
- 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.
| Acesso | Usuário | Senha |
|---|---|---|
Console web https://<ip> | suporte | Gerada no primeiro boot. Aparece no console da VM e fica em /root/orbivm-acesso.txt |
| Sistema (console da VM e SSH) | orbivm | orbivm, com troca obrigatória no primeiro login |
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
- Em Inventário › Hosts e conexões, clique em Adicionar.
- 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.
- 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:
- Abra Administração › Atualizações e veja a versão disponível e as novidades.
- 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).
- Se a versão nova não subir saudável, o Orbivm volta sozinho para a anterior.
/opt/orbivm/backups.Backup de VMs
Em Proteção › Backup de VMs:
- 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).
- Crie uma política: VMs, destino, dias, horário e quantas cópias manter.
- 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
- Firewall com entrada apenas em 22 (SSH), 80 (redireciona para HTTPS) e 443.
- Atualizações de segurança do sistema automáticas.
- Senhas de hosts, chaves e tokens cifrados; auditoria de todas as ações.
- Atualizações do Orbivm assinadas, com backup e reversão automática.
Suporte
Escreva para contato@orbivm.com com a versão (rodapé da console) e o que aconteceu. O manual completo também está dentro do produto, em Manual.