# 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/it/docs/): what is in these docs ## Inizia - [Cos'è NexCMP](https://nexcmp.com/it/docs/getting-started/what-is-nexcmp.md): NexCMP è un portale clienti self-hosted, sistema di billing e console admin per vendere macchine virtuali e servizi cloud su CloudStack o Proxmox VE. - [Requisiti per il server NexCMP](https://nexcmp.com/it/docs/getting-started/requirements.md): Requisiti hardware, di sistema operativo, di rete e DNS per il server che esegue NexCMP. - [Licenza e acquisto](https://nexcmp.com/it/docs/getting-started/license-and-purchase.md): Come funziona il sistema di licenze di NexCMP: ottenimento, associazione al dominio, aggiornamenti e gestione della scadenza. - [Installa NexCMP](https://nexcmp.com/it/docs/getting-started/installation.md): Installa NexCMP su Ubuntu con il programma di installazione a riga singola: parametri, operazioni eseguite, TLS e nginx, e accesso alla procedura guidata. - [DNS e Cloudflare](https://nexcmp.com/it/docs/getting-started/dns-and-cloudflare.md): Puntare il dominio sul server NexCMP, eventualmente tramite Cloudflare, e ottenere un certificato valido con la modalità SSL corretta. - [Procedura di configurazione](https://nexcmp.com/it/docs/getting-started/setup-wizard.md): Segui la procedura guidata di prima installazione su /setup: codice di configurazione, licenza, CloudStack o Connetti dopo, amministratore e brand. - [Primo accesso e passaggi successivi](https://nexcmp.com/it/docs/getting-started/first-login.md): Accedi alla console di amministrazione per la prima volta e completa la checklist di configurazione consigliata. - [Aggiornamento di NexCMP](https://nexcmp.com/it/docs/getting-started/updating.md): Aggiorna NexCMP dalla console di amministrazione o dalla riga di comando, scopri come vengono verificate le release e a cosa hai diritto. - [Note di rilascio](https://nexcmp.com/it/docs/getting-started/release-notes.md): Novità da NexCMP 1.3 a 1.6.1 e cosa verificare durante l'upgrade: gestione AI, misurazione VPN, servizi clienti e Bare Metal. - [Backup and restore](https://nexcmp.com/it/docs/getting-started/backup-and-restore.md): Esegui un backup coerente dei dati e della configurazione di NexCMP con nexcmp backup e ripristinalo sullo stesso server o su uno nuovo. - [Disinstallazione di NexCMP](https://nexcmp.com/it/docs/getting-started/uninstall.md): Rimuovi servizi e programma NexCMP, con o senza eliminazione dei dati, e scopri cosa rimane sulla tua infrastruttura. - [Riferimento comandi nexcmp](https://nexcmp.com/it/docs/getting-started/cli-reference.md): Tutti i sottocomandi dello strumento CLI per server nexcmp: status, update, backup, uninstall, open-port, close-port e fix-owner. ## Infrastruttura - [Requisiti infrastrutturali](https://nexcmp.com/it/docs/infrastructure/requirements.md): Una tabella unica: per ogni modulo di NexCMP, l'infrastruttura minima richiesta e la pagina che spiega come prepararlo e collegarlo. - [Architettura](https://nexcmp.com/it/docs/infrastructure/architecture.md): Come è strutturato NexCMP: dominio, nginx, il pannello e i servizi worker, oltre a ogni sistema a cui si connettono, con porte e dati utilizzati. - [Moduli](https://nexcmp.com/it/docs/infrastructure/modules.md): Tutti i moduli NexCMP con stato predefinito, funzioni aggiunte, requisiti di infrastruttura e attivazione, inclusi i moduli add-on caricati all'avvio. - [Zone](https://nexcmp.com/it/docs/infrastructure/zones.md): Come funzionano le zone NexCMP: la sede scelta all'ordine, come si collegano a CloudStack, Proxmox VE, VPN e S3 e quando sono pronte per la vendita. - [CloudStack](https://nexcmp.com/it/docs/infrastructure/cloudstack.md): Collega Apache CloudStack a NexCMP: crea un dominio, un account e una chiave API dedicati con cmk, quindi inseriscili nella procedura o nella console. - [Proxmox VE](https://nexcmp.com/it/docs/infrastructure/proxmox.md): Aggiungi cluster Proxmox VE come origine VM: token API a privilegi minimi, storage, template di immagini cloud, pool IP, blocco TLS e origine per piano. - [Template di OS e ISO](https://nexcmp.com/it/docs/infrastructure/templates.md): Prepara le immagini OS distribuite dai clienti: compila e registra i template di CloudStack e crea i template di immagini cloud per Proxmox VE. - [Server dedicati (bare metal)](https://nexcmp.com/it/docs/infrastructure/dedicated.md): Vendi server Dell gestiti tramite iDRAC e Redfish: prerequisiti di rete e ISO per i server, importazione, interruttori di sicurezza, template e piani. - [Nodi VPN e proxy IPv6](https://nexcmp.com/it/docs/infrastructure/vpn-proxy-nodes.md): Prepara host Linux come nodi VPN (cmp-agent) e nodi proxy IPv6: sistema operativo, indirizzi IP e prefissi IPv6, porte, sysctl, installazione e heartbeat. - [AI Models](https://nexcmp.com/it/docs/infrastructure/ai-models.md): Vendi modelli AI dal tuo gateway: aggiungi provider OpenAI o Anthropic, sincronizza modelli, fissa i prezzi e offri un endpoint unico con chiavi e wallet. - [Object Storage (S3, Ceph RGW)](https://nexcmp.com/it/docs/infrastructure/s3.md): Vendi storage S3 pay-as-you-go sul tuo cluster Ceph: requisiti RGW, utente admin e privilegi, e come collegare il backend a una zona in NexCMP. - [Kubernetes e Private Cloud](https://nexcmp.com/it/docs/infrastructure/kubernetes-and-private-cloud.md): Vendi cluster Kubernetes (CKS) e Private Cloud (VPC) con banda dedicata su CloudStack: offerte richieste e punti di connessione. ## Catalogo e prezzi - [Piani e prezzi](https://nexcmp.com/it/docs/catalog/plans.md): Crea e prezza i piani VM: taglie, prezzi orari/mensili, cicli di fatturazione, piani personalizzati e modifiche di prezzo. - [Quote di banda e add-on](https://nexcmp.com/it/docs/catalog/bandwidth.md): Come NexCMP conteggia il traffico per servizio dalle statistiche di CloudStack, quote predefinite, avvisi all'80% e 100%, azioni e componenti aggiuntivi. - [Valute e tassi di cambio](https://nexcmp.com/it/docs/catalog/currency-and-exchange-rates.md): Come NexCMP gestisce le somme in USD, mostra altre valute per lingua e come un amministratore pubblica il tasso USD/VND e i tassi di visualizzazione. ## Fatturazione e pagamenti - [Canali di pagamento](https://nexcmp.com/it/docs/billing/payment-channels.md): Come i clienti ricaricano il proprio portafoglio in NexCMP: i canali disponibili, come abilitarli,commissioni, limiti e monitoraggio. - [Stripe](https://nexcmp.com/it/docs/billing/stripe.md): Collega Stripe a NexCMP per pagamenti con carta, Apple Pay, Google Pay, Link e Alipay: chiavi API, webhook, registrazione dominio e pagamento di test. - [PayPal](https://nexcmp.com/it/docs/billing/paypal.md): Collega PayPal a NexCMP per le ricariche del portafoglio: credenziali dell'app REST, webhook, test in sandbox e account PayPal salvati. - [USDT (Binance)](https://nexcmp.com/it/docs/billing/usdt.md): Accetta ricariche wallet in USDT monitorando un indirizzo Binance: chiave API di sola lettura, scelta rete, verifica indirizzo e depositi non abbinati. - [Bonifico bancario (Vietnam)](https://nexcmp.com/it/docs/billing/bank-transfer-vn.md): Accetta bonifici bancari vietnamiti (VND) con SePay: conto di ricezione, prefisso memo, webhook, limiti e assegnazione dei trasferimenti non abbinati. - [Ricarica minima](https://nexcmp.com/it/docs/billing/minimum-top-up.md): Imposta la ricarica del portafoglio minima e massima per pagamento e comprendi gli altri limiti di saldo che determinano se un cliente può ordinare. - [Metodi di pagamento salvati](https://nexcmp.com/it/docs/billing/saved-payment-methods.md): Come i clienti salvano una carta, un portafoglio Stripe o un account PayPal per la ricarica automatica, come rimuoverli e cosa memorizza NexCMP. - [Ricaricamento automatico](https://nexcmp.com/it/docs/billing/auto-top-up.md): Mantieni i crediti dei clienti sempre attivi con carta o PayPal salvati: modalità a consumo o fissa, limiti globali e gestione errori. - [Fatture e registro](https://nexcmp.com/it/docs/billing/invoices-and-ledger.md): Dove viene registrato il denaro in NexCMP: mastro del wallet, fatture, ricariche, rimborsi, liquidazioni, voucher e report sui ricavi. - [Promozioni](https://nexcmp.com/it/docs/billing/promotions.md): Emetti codici ricarica: bonus wallet, credito solo servizi e sconti percentuali con limite e ordine minimo — creali, distribuiscili e monitorali. - [Quote](https://nexcmp.com/it/docs/billing/quotas.md): Limita ciò che un nuovo cliente può creare prima di ricaricare il wallet: tier risorse VM, conteggio VM e quote per servizio, con override per cliente. ## Clienti e rivenditori - [Gestione dei clienti](https://nexcmp.com/it/docs/customers/managing-customers.md): Trova e assisti i clienti: elenco clienti, paese da IP, origine referral, azioni account, richieste di eliminazione e trasferimenti di servizi. - [Accedi come cliente](https://nexcmp.com/it/docs/customers/login-as.md): Apri il portale clienti come uno specifico cliente per un'ora per riprodurre un problema — condizioni, protezioni, e ciò che viene bloccato e registrato. - [Resellers (white-label)](https://nexcmp.com/it/docs/customers/resellers.md): Consenti ai partner di vendere il tuo cloud con il proprio brand: crea reseller, imposta domini e DNS, prezzi all'ingrosso, default e slot licenza. - [Branding](https://nexcmp.com/it/docs/customers/branding.md): Personalizza portale clienti, console e email con nome, logo, colore e valuta — regole di caricamento e dove appare ogni impostazione. - [Pagine legali](https://nexcmp.com/it/docs/customers/legal.md): Redigi i Termini di servizio e l'Informativa sulla privacy su /terms e /privacy: testo neutro di default, versioni EN e VI e regole markdown sicure. ## Portale clienti - [Panoramica del portale clienti](https://nexcmp.com/it/docs/portal/overview.md): Una panoramica del portale clienti: dashboard, menu, portafoglio, macchine virtuali, impostazioni account, lingua e valuta. - [Registrazione, portafoglio e ricarica](https://nexcmp.com/it/docs/portal/sign-up-and-wallet.md): Come i clienti si registrano, verificano l'e-mail, aggiungono credito al portafoglio, riscattano codici e consultano la cronologia di fatturazione. - [Ordinare un servizio](https://nexcmp.com/it/docs/portal/ordering.md): La pagina ordini passo dopo passo: servizio, localizzazione, piano, ciclo di fatturazione, sistema operativo, hostname, quantità e pagamento dal portale. - [Macchine virtuali](https://nexcmp.com/it/docs/portal/virtual-machines.md): Gestione di una macchina virtuale dal portale: panoramica, azioni di alimentazione, reset password, reinstallazione, monitoraggio, rete e attività. - [Console](https://nexcmp.com/it/docs/portal/console.md): Apri una console VM nel browser (VNC) e opzionalmente un terminale SSH web; i requisiti di ciascuno per la tua infrastruttura. - [Snapshots e backups](https://nexcmp.com/it/docs/portal/snapshots.md): Crea, ripristina ed elimina snapshot di VM dal portale, pianificali e scopri cosa supporta ogni origine. - [Supporto per i clienti](https://nexcmp.com/it/docs/portal/support.md): Come i clienti ricevono aiuto: il fumetto della chat con risposte IA, i collegamenti a Telegram e Zalo e i ticket. ## IA - [Provider IA](https://nexcmp.com/it/docs/ai/ai-providers.md): Collega un endpoint IA compatibile con OpenAI per AI Chat e l'AI Agent: attiva il modulo IA, inserisci endpoint e chiave, testalo e imposta i limiti. - [AI Chat](https://nexcmp.com/it/docs/ai/ai-chat.md): Chat di supporto automatica per clienti connessi: funzioni, inoltro al team via Telegram/Zalo, pulsanti rapidi Telegram e limiti sotto il tuo controllo. - [AI Agent](https://nexcmp.com/it/docs/ai/ai-agent.md): Consenti ai clienti di gestire le VM Linux descrivendo le attività: connessione via SSH dell'Agent, comandi autonomi consentiti e requisiti necessari. ## Sviluppatori - [REST API](https://nexcmp.com/it/docs/developers/api.md): Chiama l'API clienti della tua installazione NexCMP: autenticazione, riferimento interattivo, download OpenAPI e Postman, errori, rate limit, idempotenza ed esempi curl. - [Chiavi API e ambiti](https://nexcmp.com/it/docs/developers/api-keys.md): Come i clienti creano chiavi API (prefisso vk_), scelgono gli scope, li limitano per IP e scadenza, e come gli amministratori le esaminano e le revocano. - [strumento a riga di comando cmp](https://nexcmp.com/it/docs/developers/cmp-cli.md): Installa e usa la CLI cmp del tuo pannello: login browser con codice monouso, comandi da API, output, codici di uscita, CI e aggiornamenti firmati. - [Server MCP](https://nexcmp.com/it/docs/developers/mcp.md): Collega assistenti AI (Claude, Cursor, VS Code) all'API con l'endpoint MCP /mcp: autenticazione, configurazione client, strumenti e regole di sicurezza. ## Configura con l'IA - [Configura con l'IA](https://nexcmp.com/it/docs/configure-with-ai/overview.md): Configura e gestisci NexCMP con un assistente AI: AI Chat nell'admin, client AI via MCP o file YAML. Funzionalità disponibili e regole di sicurezza. - [AI Chat nell'amministrazione](https://nexcmp.com/it/docs/configure-with-ai/ai-chat-in-admin.md): Configura NexCMP via chat nell'admin: scegli una fonte AI, verifica ogni scheda di conferma, passa secret in sicurezza e limita la spesa giornaliera. - [Account e abbonamenti IA](https://nexcmp.com/it/docs/configure-with-ai/ai-accounts-and-subscriptions.md): Collega la sorgente AI per AI Chat (chiavi API, login OpenRouter o Google, provider del pannello) e usa il tuo abbonamento Claude, ChatGPT o Gemini tramite le CLI ufficiali. - [Chiavi API amministrative](https://nexcmp.com/it/docs/configure-with-ai/admin-api-keys.md): Crea e revoca chiavi admin ak_ per AI Agent e script: otto scope, scadenza, range IP, rate limit, cosa non possono mai fare e tutti i codici di errore. - [Connettere un client AI (MCP)](https://nexcmp.com/it/docs/configure-with-ai/mcp-admin.md): Collega Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai, ChatGPT o SDK OpenAI all'endpoint MCP admin del pannello con tutti i tool. - [Connettori claude.ai e ChatGPT](https://nexcmp.com/it/docs/configure-with-ai/oauth-connectors.md): Collega app AI web come claude.ai e ChatGPT al pannello con OAuth 2.1: accedi come amministratore, seleziona permessi e durata, e revoca quando vuoi. - [Configurazione come codice](https://nexcmp.com/it/docs/configure-with-ai/config-as-code.md): Esporta la configurazione in YAML, vedi le modifiche e applicale con nexcmp config o Import/Export; i secret restano esclusi e JSON Schema la valida. - [Prompt di esempio](https://nexcmp.com/it/docs/configure-with-ai/example-prompts.md): Prompt pronti per AI Chat o il tuo client AI: setup, Proxmox, tabella piani con margine, SMTP, Stripe, Telegram, credito clienti ed export configurazione. - [Elenco di controllo per la configurazione](https://nexcmp.com/it/docs/configure-with-ai/setup-checklist.md): La scheda di configurazione su Overview mostra dieci passaggi e fa eseguire il prossimo a un assistente AI con Do it for me. ## Amministrazione - [SMTP e template email](https://nexcmp.com/it/docs/administration/smtp-and-emails.md): Configura l'invio di email (SMTP), invia un messaggio di test, modifica i template email in ogni lingua e leggi il registro di consegna. - [Telegram e avvisi amministratore](https://nexcmp.com/it/docs/administration/telegram-notifications.md): Invia avvisi operativi ed eventi di registrazione e deposito a un gruppo Telegram, webhook o e-mail, e configura le scorciatoie di supporto per i clienti. - [Log di controllo e attività](https://nexcmp.com/it/docs/administration/audit-log.md): Consulta chi ha fatto cosa: cronologia delle attività, azioni amministrative, accessi e-mail. - [Sicurezza](https://nexcmp.com/it/docs/administration/security.md): Proteggi la console admin con 2FA e allowlist IP, gestisci ruoli admin e login clienti: passkey, Google e GitHub, captcha e domini e-mail bloccati. - [Impostazioni generali](https://nexcmp.com/it/docs/administration/general-settings.md): Nome del brand e URL, dettagli del venditore stampati sulle fatture, prefisso dei numeri di fattura, lingua predefinita e modalità manutenzione clienti. - [Segnala un bug](https://nexcmp.com/it/docs/administration/report-a-bug.md): Invia una segnalazione bug dalla console admin al team NexCMP come ticket: modulo, cosa viene inviato, cosa no, limiti e soluzioni agli errori comuni. ## Risoluzione dei problemi e FAQ - [Errori di installazione](https://nexcmp.com/it/docs/troubleshooting/installation-errors.md): Tutti i messaggi di errore dell'installatore NexCMP, cause e soluzioni: requisiti, licenza, verifica download, servizi e nginx/TLS. - [Errori di aggiornamento](https://nexcmp.com/it/docs/troubleshooting/update-errors.md): Perché un aggiornamento di NexCMP può fallire (diritto, verifica del download, firma, riavvio) e come ripristinare o eseguire il rollback. - [FAQ](https://nexcmp.com/it/docs/troubleshooting/faq.md): Domande frequenti su installazione, licenze, connessione dell'infrastruttura ed esecuzione di NexCMP. - [Support](https://nexcmp.com/it/docs/troubleshooting/support.md): Come ottenere assistenza per NexCMP: cosa raccogliere, cosa includere nel messaggio e dove inviarlo. ## Optional - [Full documentation in one file](https://nexcmp.com/it/docs/llms-full.txt) - [Sitemap](https://nexcmp.com/it/docs/sitemap.xml) - [Product site](https://nexcmp.com)