TimInTech/proxmox-manager

O que é?

Recursos principais

• 01Lista todas as VMs e os containers com status em execução, parados, pausados ou desconhecido.
• 02Ações para iniciar, parar e reiniciar, com solicitações de confirmação e opção de parada forçada como alternativa.
• 03Acesso ao console via pct enter para containers ou qm terminal para VMs.
• 04Listagem, criação, reversão e exclusão de snapshots, com validação de nomes.
• 05Geração de arquivos SPICE .vv e inicialização automática do virt-viewer quando instalado.
• 06Saída JSON e filtros para uso em scripts e pipelines do jq.
• 07Visão geral de integridade e alertas via cron por ntfy ou e-mail.

Casos de uso

• Gerenciar VMs e containers em um único nó Proxmox de homelab pelo terminal.
• Criar scripts para verificar status ou executar tarefas autônomas de inicialização e parada com saída JSON.
• Receber notificações no celular ou por e-mail quando um guest ficar sem CPU, memória ou espaço em disco.
• Abrir consoles e sessões SPICE sem usar a interface web.

Início rápido

1. 1

   Clone o repositório

   git clone https://github.com/TimInTech/proxmox-manager.git
2. 2

   Acesse o diretório do projeto

   cd proxmox-manager
3. 3

   Torne o script executável e execute-o como root no nó Proxmox

   chmod +x proxmox-manager.sh && ./proxmox-manager.sh

Antes de usar

• !Deve ser executado diretamente como root em um host Proxmox VE; requer as ferramentas qm, pct e pvesh.
• !Funciona apenas no Proxmox VE 7, 8 e 9 e gerencia somente o nó local.
• !Os alertas por e-mail são opcionais e exigem uma configuração local do sendmail, como o postfix.

Tópicos

Perguntas frequentes

O que é proxmox-manager?

TUI em Bash de arquivo único para listar, iniciar, parar, criar snapshots e monitorar máquinas virtuais e containers no Proxmox VE. proxmox-manager (comando pman) é um script Bash de arquivo único que roda como root diretamente em um nó Proxmox VE. Ele exibe uma tabela com todas as VMs e os containers LXC, mostrando o status em tempo real, e oferece menus de ações para iniciar, parar, reiniciar, abrir um console, gerenciar snapshots e obter arquivos de conexão SPICE. Ele depende apenas de ferramentas incluídas no Proxmox, como qm, pct e pvesh, e não precisa de daemon nem de agente.

proxmox-manager é gratuito? Qual é a licença?

proxmox-manager é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

proxmox-manager ainda é mantido?

Manutenção ativa. O último commit de proxmox-manager foi em 19 de out. de 2026.

Para que posso usar proxmox-manager?

Gerenciar VMs e containers em um único nó Proxmox de homelab pelo terminal. Criar scripts para verificar status ou executar tarefas autônomas de inicialização e parada com saída JSON. Receber notificações no celular ou por e-mail quando um guest ficar sem CPU, memória ou espaço em disco. Abrir consoles e sessões SPICE sem usar a interface web.

Como instalar proxmox-manager?

Clone o repositório: git clone https://github.com/TimInTech/proxmox-manager.git Acesse o diretório do projeto: cd proxmox-manager Torne o script executável e execute-o como root no nó Proxmox: chmod +x proxmox-manager.sh && ./proxmox-manager.sh

Onde consigo proxmox-manager?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/TimInTech/proxmox-manager