Installazione

QuoteNode funziona come container Docker. In una distribuzione normale non serve installare Java, Node.js, PostgreSQL o Gotenberg sull’host. La decisione principale riguarda da dove l’applicazione sarà raggiungibile: solo dal tuo portatile, dalla rete dell’ufficio (LAN) o da internet.

Ogni guida installa un pacchetto di release: un file Compose che esegue le immagini testate della release, fissate tramite digest. Sulla tua macchina non viene compilato nulla, e ogni installazione di una release usa le stesse immagini. Le immagini delle release sono costruite per host x86 a 64 bit (linux/amd64).

Scegli il percorso di distribuzione

Topologia	Indirizzo	Link pubblici alle offerte	Link nelle e-mail	HTTPS	Uso previsto
Portatile/locale	http://localhost	solo sulla stessa macchina	inutili per clienti esterni	no	prova/demo
Windows in LAN	http://<ip-del-pc> o DNS locale	solo client nella LAN	solo destinatari interni	opzionale/interno	prova in ufficio
Server Linux in LAN	http://<ip-del-server> o DNS locale	solo client LAN/VPN	interni se non raggiungibili	opzionale/interno	team commerciale interno
Server pubblico Ubuntu (VPS)	dominio pubblico + HTTPS	funzionano per i clienti	funzionano con SMTP e dominio configurati	obbligatorio	produzione beta
Portainer/QNAP/NAS	interfaccia Docker specifica dell’host	dipende da instradamento/NAT/dominio	dipende da instradamento/SMTP	obbligatorio per i link dei clienti	uso avanzato domestico/PMI
Coolify	dominio pubblico + proxy gestito	funzionano per i clienti	funzionano con SMTP e dominio configurati	gestito da Coolify	la distribuzione pubblica più semplice

Guide di installazione

• Portatile locale — valutazione rapida su una sola macchina.
• Server Windows in LAN — Docker Desktop su un PC raggiungibile nella rete dell’ufficio.
• Server Linux in LAN — Docker Engine su un server interno o una VM.
• Server pubblico Ubuntu — dominio pubblico, HTTPS, SMTP, backup e nozioni di firewall.
• Coolify — pacchetto di release in una risorsa Docker Compose di Coolify, dietro il suo proxy.
• Portainer, QNAP o NAS — indicazioni avanzate per piattaforme con interfaccia Docker.
• Aggiornare QuoteNode — passare al pacchetto di release successivo e tornare indietro in sicurezza.

Riferimenti comuni

• Variabili d’ambiente della distribuzione — variabili minime per le guide di installazione.
• Risoluzione dei problemi di installazione — problemi comuni con link, CORS, SMTP, DNS e perdita dei segreti.
• Riferimento delle variabili d’ambiente — catalogo completo delle variabili.
• Backup e ripristino — strategia di backup e ripristino.
• Opzioni di distribuzione — panoramica a livello di architettura.

Prima di pubblicare i link

QuoteNode genera link pubblici alle offerte, link alle preferenze di notifica ed e-mail. Questi link funzionano solo per i destinatari che possono raggiungere lo stesso indirizzo usato dal browser.

• Un link generato su http://localhost funziona solo sulla stessa macchina.
• Un link generato su http://192.168.x.x funziona solo per le persone in quella LAN o VPN.
• Un link generato su https://crm.example.com funziona pubblicamente solo con DNS, HTTPS, instradamento del proxy e firewall configurati correttamente.
• L’invio di e-mail richiede SMTP. Il download manuale del PDF e la condivisione manuale di un link pubblico no.

Risorse minime

Distribuzione	RAM	CPU	Disco
Valutazione / uso individuale	2 GB	1 core	10 GB SSD
Piccolo team	4 GB	2 core	20 GB SSD
Ambiente beta più ampio	8 GB	4 core	50 GB SSD

Sono valori di partenza prudenti. Cataloghi grandi, generazione frequente di PDF, molti backup e immagini dei prodotti aumentano il fabbisogno di disco e memoria.

I limiti dei container, la regolazione di RAM/CPU e come evitare la mancanza di memoria sono descritti in Risorse di sistema.