# NexCMP Docs > Documentation for NexCMP 1.6.1: a self-hosted cloud management and billing platform for CloudStack and Proxmox VE (customer portal, billing, resellers, AI chat/agent, API). Every page below is also available as raw Markdown by adding .md to the URL; the whole documentation is in llms-full.txt. - [Overview](https://nexcmp.com/pt/docs/): what is in these docs ## Primeiros passos - [O que é o NexCMP](https://nexcmp.com/pt/docs/getting-started/what-is-nexcmp.md): O NexCMP é um portal do cliente, sistema de faturamento e console admin self-hosted que vende máquinas virtuais e serviços em nuvem no seu CloudStack ou Proxmox VE. - [Requisitos para o servidor NexCMP](https://nexcmp.com/pt/docs/getting-started/requirements.md): Requisitos de hardware, sistema operacional, rede e DNS para o servidor que executa o próprio NexCMP. - [Licença e compra](https://nexcmp.com/pt/docs/getting-started/license-and-purchase.md): Como funciona o licenciamento do NexCMP — obter chave, vincular a domínio, domínios de revenda, direito a updates e o que ocorre se a licença expirar. - [Instalar o NexCMP](https://nexcmp.com/pt/docs/getting-started/installation.md): Instale o NexCMP no Ubuntu com o instalador de uma linha — parâmetros, o que o instalador faz, TLS e nginx, e como acessar o assistente de configuração. - [DNS e Cloudflare](https://nexcmp.com/pt/docs/getting-started/dns-and-cloudflare.md): Aponte seu domínio para o servidor NexCMP, opcionalmente através do Cloudflare, e obtenha um certificado válido com o modo SSL correto. - [Assistente de configuração](https://nexcmp.com/pt/docs/getting-started/setup-wizard.md): Acompanhe o assistente de primeiro uso em /setup — código de setup, licença, CloudStack ou Connect depois, administrador e marca. - [Primeiro login e próximos passos](https://nexcmp.com/pt/docs/getting-started/first-login.md): Faça login no console administrativo pela primeira vez e conclua a lista de verificação de configuração recomendada. - [Atualizando o NexCMP](https://nexcmp.com/pt/docs/getting-started/updating.md): Atualize o NexCMP pelo console administrativo ou pela linha de comando, veja como as versões são verificadas e o que você tem direito de receber. - [Notas de versão](https://nexcmp.com/pt/docs/getting-started/release-notes.md): Mudanças do NexCMP 1.3 ao 1.6.1 e o que verificar ao atualizar: administração de IA, medição de VPN, serviços de clientes e Bare Metal. - [Backup and restore](https://nexcmp.com/pt/docs/getting-started/backup-and-restore.md): Faça um backup consistente dos dados e da configuração do NexCMP com nexcmp backup e restaure-o no mesmo servidor ou em um novo. - [Desinstalar o NexCMP](https://nexcmp.com/pt/docs/getting-started/uninstall.md): Remova os serviços e o programa do NexCMP, com ou sem exclusão de dados, e saiba o que permanece na sua infraestrutura. - [Referência de comandos do nexcmp](https://nexcmp.com/pt/docs/getting-started/cli-reference.md): Todos os subcomandos da ferramenta de linha de comando nexcmp server — status, update, backup, uninstall, open-port, close-port e fix-owner. ## Infraestrutura - [Requisitos de infraestrutura](https://nexcmp.com/pt/docs/infrastructure/requirements.md): Uma tabela: para cada módulo do NexCMP, a infraestrutura mínima necessária e a página que explica como prepará-lo e conectá-lo. - [Arquitetura](https://nexcmp.com/pt/docs/infrastructure/architecture.md): Como o NexCMP é estruturado: domínio, nginx, painel, serviços worker e todos os sistemas conectados, com portas e dados usados. - [Módulos](https://nexcmp.com/pt/docs/infrastructure/modules.md): Todos os módulos do NexCMP com o estado padrão, o que adicionam, a infraestrutura necessária e onde ativá-los; incluindo os add-on lidos na inicialização. - [Zonas](https://nexcmp.com/pt/docs/infrastructure/zones.md): Como funcionam as zonas do NexCMP: o local escolhido no pedido, a conexão com CloudStack, Proxmox VE, VPN e S3, e quando ela está pronta para venda. - [CloudStack](https://nexcmp.com/pt/docs/infrastructure/cloudstack.md): Conecte o Apache CloudStack ao NexCMP: crie um domínio, conta e chave de API dedicados com o cmk e informe-os no assistente ou no console admin. - [Proxmox VE](https://nexcmp.com/pt/docs/infrastructure/proxmox.md): Adicione clusters Proxmox VE como origem de VM: token de API com menor privilégio, armazenamento, modelos cloud-image, pools de IP e fixação TLS. - [Templates de OS e ISOs](https://nexcmp.com/pt/docs/infrastructure/templates.md): Prepare as imagens de SO que os clientes implantam: crie e registre templates do CloudStack e monte templates de cloud-image do Proxmox VE. - [Servidores dedicados (bare metal)](https://nexcmp.com/pt/docs/infrastructure/dedicated.md): Venda servidores Dell gerenciados via iDRAC e Redfish: pré-requisitos de rede e ISO, importação de servidores, chaves de segurança, modelos e planos. - [Nós de VPN e proxy IPv6](https://nexcmp.com/pt/docs/infrastructure/vpn-proxy-nodes.md): Prepare Linux hosts as VPN and IPv6 proxy nodes: OS, IP addresses, IPv6 prefixes, ports, sysctl, install and heartbeat. - [AI Models](https://nexcmp.com/pt/docs/infrastructure/ai-models.md): Venda acesso a modelos de IA no seu gateway: integre APIs OpenAI ou Anthropic, sincronize modelos, defina preços e libere um endpoint com chaves e wallet. - [Object Storage (S3, Ceph RGW)](https://nexcmp.com/pt/docs/infrastructure/s3.md): Venda armazenamento S3 pré-pago no seu cluster Ceph: requisitos do RGW, usuário admin e cotas, e como conectar o backend a uma zona no NexCMP. - [Kubernetes and Private Cloud](https://nexcmp.com/pt/docs/infrastructure/kubernetes-and-private-cloud.md): Venda clusters Kubernetes (CKS) e Private Cloud (VPC) com largura de banda dedicada no CloudStack: ofertas necessárias e onde conectá-las. ## Catálogo e preços - [Planos e preços](https://nexcmp.com/pt/docs/catalog/plans.md): Crie e precifique planos de VM: tamanhos, preços por hora e mês, ciclos, planos personalizados, clonagem e o efeito em VMs ativas. - [Cotas de largura de banda e add-ons](https://nexcmp.com/pt/docs/catalog/bandwidth.md): Como o NexCMP mede o tráfego por serviço a partir das estatísticas do CloudStack, cotas padrão, alertas de 80% e 100%, ações de excesso e add-ons. - [Moeda e taxas de câmbio](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates.md): Como o NexCMP mantém os valores em dólares americanos, exibe outras moedas por idioma e como o administrador publica a taxa USD/VND e as taxas de exibição. ## Faturamento e pagamentos - [Canais de pagamento](https://nexcmp.com/pt/docs/billing/payment-channels.md): Como os clientes recarregam a carteira no NexCMP — os canais disponíveis, como ativar cada um, taxas, limites e como monitorá-los. - [Stripe](https://nexcmp.com/pt/docs/billing/stripe.md): Conecte o Stripe ao NexCMP para cartões, Apple Pay, Google Pay, Link e Alipay — chaves de API, webhook, registro de domínio e pagamento de teste. - [PayPal](https://nexcmp.com/pt/docs/billing/paypal.md): Conecte o PayPal ao NexCMP para recargas de saldo — credenciais de aplicativo REST, webhook, testes em sandbox e contas do PayPal salvas. - [USDT (Binance)](https://nexcmp.com/pt/docs/billing/usdt.md): Aceite recargas em USDT monitorando endereço de depósito da Binance — chave de API somente leitura, escolha de rede e depósitos não reconciliados. - [Transferência bancária (Vietnã)](https://nexcmp.com/pt/docs/billing/bank-transfer-vn.md): Aceite transferências bancárias (VND) com Sepay — conta de destino, prefixo de memo, webhook, limites e como atribuir transações não conciliadas. - [Recarga mínima](https://nexcmp.com/pt/docs/billing/minimum-top-up.md): Defina a menor e a maior recarga de carteira por pagamento e compreenda os outros limites de saldo que determinam se um cliente pode fazer pedidos. - [Saved payment methods](https://nexcmp.com/pt/docs/billing/saved-payment-methods.md): Como os clientes salvam um cartão, uma carteira Stripe ou uma conta PayPal para recarga automática, como removê-los e o que o NexCMP armazena. - [Auto top-up](https://nexcmp.com/pt/docs/billing/auto-top-up.md): Mantenha as carteiras dos clientes com saldo automático via cartão salvo ou PayPal — modos por uso e fixo, limites globais e tratamento de falhas. - [Faturas e razão](https://nexcmp.com/pt/docs/billing/invoices-and-ledger.md): Onde o dinheiro é registrado no NexCMP — o razão da carteira, faturas, pagamentos de recarga, reembolsos e repasses, vales e relatórios de receita. - [Promoções](https://nexcmp.com/pt/docs/billing/promotions.md): Emita códigos de recarga: bônus de carteira, crédito para serviços e descontos percentuais com teto e pedido mínimo — crie, distribua e acompanhe. - [Quotas](https://nexcmp.com/pt/docs/billing/quotas.md): Limite a criação de recursos para novos clientes até que financiem a carteira — níveis de VM, contagem de VMs e cotas. ## Clientes e revendedores - [Gerenciando clientes](https://nexcmp.com/pt/docs/customers/managing-customers.md): Encontre e atenda clientes: lista de clientes, país por IP, origem de indicação, ações de conta, pedidos de exclusão e transferências. - [Fazer login como cliente](https://nexcmp.com/pt/docs/customers/login-as.md): Abra o portal do cliente como um cliente específico por uma hora para reproduzir um problema — condições, proteções e o que é bloqueado e registrado. - [Resellers (white-label)](https://nexcmp.com/pt/docs/customers/resellers.md): Permita que parceiros revendam sua nuvem com a marca e o domínio deles — crie um revendedor, defina domínios, DNS, preços de atacado e padrões. - [Branding](https://nexcmp.com/pt/docs/customers/branding.md): Personalize o portal do cliente, o console administrativo e os e-mails com sua marca, logotipo, cores e moeda. - [Páginas legais](https://nexcmp.com/pt/docs/customers/legal.md): Defina os Termos de Serviço e a Política de Privacidade em /terms e /privacy — texto neutro padrão, versões em inglês e vietnamita e markdown seguro. ## Portal do cliente - [Visão geral do portal do cliente](https://nexcmp.com/pt/docs/portal/overview.md): Um tour pelo portal do cliente: painel, menu, carteira, máquinas virtuais, configurações de conta, idioma e moeda. - [Cadastro, carteira e recarga](https://nexcmp.com/pt/docs/portal/sign-up-and-wallet.md): Como os clientes se registram, verificam o e-mail, adicionam crédito à carteira, resgatam códigos e leem seu histórico de cobrança. - [Contratar um serviço](https://nexcmp.com/pt/docs/portal/ordering.md): A página de pedidos passo a passo: serviço, localização, plano, ciclo, SO, hostname e quantidade, com pagamento via saldo. - [Máquinas virtuais](https://nexcmp.com/pt/docs/portal/virtual-machines.md): Gerenciamento de VM no portal: visão geral, energia, senha, reinstalação, monitoramento, rede, configuração e atividade. - [Console](https://nexcmp.com/pt/docs/portal/console.md): Abra um console de VM no navegador (VNC) e opcionalmente um terminal SSH web; o que cada um precisa da sua infraestrutura. - [Snapshots e backups](https://nexcmp.com/pt/docs/portal/snapshots.md): Tira, restaura e exclui snapshots de VMs pelo portal, agende-os e saiba o que cada origem suporta. - [Suporte aos clientes](https://nexcmp.com/pt/docs/portal/support.md): Como os clientes obtêm ajuda: o balão de chat com respostas de IA, atalhos do Telegram e Zalo, e tickets. ## IA - [Provedor de IA](https://nexcmp.com/pt/docs/ai/ai-providers.md): Conecte um endpoint de IA compatível com OpenAI para o AI Chat e o AI Agent — ative o módulo de IA, insira o endpoint e a chave, teste e defina limites. - [AI Chat](https://nexcmp.com/pt/docs/ai/ai-chat.md): Chat de suporte automático para clientes autenticados: repasse à equipe via Telegram e Zalo, botões de atalho e limites sob seu controle. - [AI Agent](https://nexcmp.com/pt/docs/ai/ai-agent.md): Permita aos clientes gerenciar VMs Linux em linguagem natural — como o Agent conecta via SSH, o que executa sozinho e os requisitos necessários. ## Desenvolvedores - [REST API](https://nexcmp.com/pt/docs/developers/api.md): Chame a API de cliente da sua instalação NexCMP: autenticação, a referência interativa, downloads de OpenAPI e Postman, erros, limites de taxa, idempotência e exemplos em curl. - [Chaves de API e escopos](https://nexcmp.com/pt/docs/developers/api-keys.md): Como os clientes criam chaves de API (prefixo vk_), escolhem escopos, limitam por IP e validade, e como os administradores as revisam e revogam. - [ferramenta de linha de comando cmp](https://nexcmp.com/pt/docs/developers/cmp-cli.md): Instale e use o cmp CLI do seu painel: login no navegador com código único, comandos via API, códigos de saída, uso em CI e atualizações assinadas. - [Servidor MCP](https://nexcmp.com/pt/docs/developers/mcp.md): Conecte assistentes de IA (Claude, Cursor, VS Code e mais) à API via endpoint MCP em /mcp: autenticação, configuração, ferramentas e regras de segurança. ## Configurar com IA - [Configurar com IA](https://nexcmp.com/pt/docs/configure-with-ai/overview.md): Deixe um assistente de IA configurar e gerenciar seu NexCMP: AI Chat no admin, cliente próprio via MCP ou arquivo YAML. Recursos e regras de segurança. - [AI Chat no admin](https://nexcmp.com/pt/docs/configure-with-ai/ai-chat-in-admin.md): Configure o NexCMP via chat no admin: escolha a IA, revise cards de confirmação, envie segredos com segurança e mantenha um limite de gastos diário. - [Contas e assinaturas de IA](https://nexcmp.com/pt/docs/configure-with-ai/ai-accounts-and-subscriptions.md): Conecte a fonte do AI Chat (chaves de API, OpenRouter, Google, painel) e use sua assinatura do Claude, ChatGPT ou Gemini pelas CLIs oficiais. - [Admin API keys](https://nexcmp.com/pt/docs/configure-with-ai/admin-api-keys.md): Crie e revogue chaves ak_ de admin para AI Agents e scripts: os oito escopos, validade, faixas de IP, rate limit, restrições e códigos de erro. - [Conectar um cliente de IA (MCP)](https://nexcmp.com/pt/docs/configure-with-ai/mcp-admin.md): Conecte Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai, ChatGPT e SDKs OpenAI ao endpoint MCP de admin com a lista de ferramentas. - [Conectores claude.ai e ChatGPT](https://nexcmp.com/pt/docs/configure-with-ai/oauth-connectors.md): Conecte aplicativos de IA na web, como claude.ai e ChatGPT, ao seu painel via OAuth 2.1: faça login como admin, escolha escopos e duração, e revoque quando quiser. - [Configuração como código](https://nexcmp.com/pt/docs/configure-with-ai/config-as-code.md): Exporte a configuração para YAML, pré-visualize e aplique via CLI ou página de importação/exportação. - [Exemplos de prompts](https://nexcmp.com/pt/docs/configure-with-ai/example-prompts.md): Prompts prontos para AI Chat ou cliente de IA: setup inicial, Proxmox, planos com margem, SMTP, Stripe, Telegram, créditos e exportação de configuração. - [Checklist de progresso de configuração](https://nexcmp.com/pt/docs/configure-with-ai/setup-checklist.md): O card de progresso de configuração na visão geral exibe dez passos e permite que a IA conclua um para você. ## Administração - [SMTP e modelos de e-mail](https://nexcmp.com/pt/docs/administration/smtp-and-emails.md): Configure o e-mail de envio (SMTP), envie uma mensagem de teste, edite os modelos de e-mail em cada idioma e leia o log de entrega. - [Telegram e alertas de administrador](https://nexcmp.com/pt/docs/administration/telegram-notifications.md): Envie alertas operacionais, cadastros e depósitos para Telegram, webhook ou e-mail, e configure os atalhos de suporte exibidos aos clientes. - [Log de auditoria e atividade](https://nexcmp.com/pt/docs/administration/audit-log.md): Veja quem fez o quê: histórico unificado, ações administrativas, logins, eventos de VM e e-mails enviados, e como buscar por código. - [Segurança](https://nexcmp.com/pt/docs/administration/security.md): Proteja o admin com 2FA e IPs permitidos, gerencie funções e configure o login de clientes: passkeys, Google, GitHub, captcha e domínios bloqueados. - [Configurações gerais](https://nexcmp.com/pt/docs/administration/general-settings.md): Nome da marca e URLs, detalhes do vendedor impressos nas faturas, prefixo do número da fatura, idioma padrão e modo de manutenção do cliente. - [Reportar um bug](https://nexcmp.com/pt/docs/administration/report-a-bug.md): Envie um relatório de bug do admin à equipe NexCMP como ticket: formulário, o que é enviado, o que nunca é enviado, limites e soluções para erros comuns. ## Solução de problemas e FAQ - [Erros de instalação](https://nexcmp.com/pt/docs/troubleshooting/installation-errors.md): Todas as mensagens de erro do instalador do NexCMP, causas e soluções: requisitos, ativação de licença, verificação de download, serviços e nginx/TLS. - [Erros de atualização](https://nexcmp.com/pt/docs/troubleshooting/update-errors.md): Por que uma atualização do NexCMP pode falhar — direito, verificação de download, assinatura, reinicialização — e como recuperar ou reverter. - [FAQ](https://nexcmp.com/pt/docs/troubleshooting/faq.md): Perguntas frequentes sobre instalação, licenciamento, conexão de infraestrutura e execução do NexCMP. - [Suporte](https://nexcmp.com/pt/docs/troubleshooting/support.md): Como obter ajuda com o NexCMP: o que coletar, o que incluir em sua mensagem e para onde enviá-la. ## Optional - [Full documentation in one file](https://nexcmp.com/pt/docs/llms-full.txt) - [Sitemap](https://nexcmp.com/pt/docs/sitemap.xml) - [Product site](https://nexcmp.com)