Installation

QuoteNode fonctionne sous forme de conteneurs Docker. Pour un déploiement normal, vous n’installez ni Java, ni Node.js, ni PostgreSQL, ni Gotenberg sur l’hôte. La décision principale porte sur l’endroit d’où l’application sera accessible : uniquement depuis votre ordinateur portable, depuis le réseau du bureau (LAN) ou depuis l’internet public.

Chaque guide installe un paquet de version : un fichier Compose qui exécute les images testées de la version, épinglées par digest. Rien n’est compilé sur votre machine, et chaque installation d’une version utilise les mêmes images. Les images des versions sont construites pour des hôtes x86 64 bits (linux/amd64).

Choisir votre mode de déploiement

Topologie	Adresse	Liens publics d’offres	Liens dans les e-mails	HTTPS	Usage prévu
Portable/local	http://localhost	uniquement sur la même machine	inutiles pour les clients externes	non	essai/démo
Windows en LAN	http://<ip-du-pc> ou DNS local	uniquement les clients du LAN	uniquement les destinataires internes	optionnel/interne	essai au bureau
Serveur Linux en LAN	http://<ip-du-serveur> ou DNS local	uniquement les clients LAN/VPN	internes sauf si accessibles	optionnel/interne	équipe commerciale interne
Serveur public Ubuntu (VPS)	domaine public + HTTPS	fonctionnent pour les clients	fonctionnent si SMTP et domaine sont configurés	obligatoire	production bêta
Portainer/QNAP/NAS	interface Docker propre à l’hôte	selon routage/NAT/domaine	selon routage/SMTP	obligatoire pour les liens clients	usage avancé domicile/PME
Coolify	domaine public + proxy géré	fonctionnent pour les clients	fonctionnent si SMTP et domaine sont configurés	géré par Coolify	déploiement public le plus simple

Guides d’installation

• Ordinateur portable local — évaluation rapide sur une seule machine.
• Serveur Windows en LAN — Docker Desktop sur un PC accessible dans le réseau du bureau.
• Serveur Linux en LAN — Docker Engine sur un serveur interne ou une VM.
• Serveur public Ubuntu — domaine public, HTTPS, SMTP, sauvegardes et bases du pare-feu.
• Coolify — paquet de version dans une ressource Docker Compose de Coolify, derrière son proxy.
• Portainer, QNAP ou NAS — conseils avancés pour les plateformes à interface Docker.
• Mettre à jour QuoteNode — passer au paquet de version suivant et revenir en arrière en sécurité.

Références communes

• Variables d’environnement de déploiement — variables minimales pour les guides d’installation.
• Résolution des problèmes d’installation — problèmes courants de liens, CORS, SMTP, DNS et perte de secrets.
• Référence des variables d’environnement — catalogue complet des variables.
• Sauvegarde et restauration — stratégie de sauvegarde et restauration.
• Options de déploiement — vue d’ensemble au niveau de l’architecture.

Avant de publier des liens

QuoteNode génère des liens publics d’offres, des liens vers les préférences de notification et des e-mails. Ces liens ne fonctionnent que pour les destinataires qui peuvent joindre la même adresse que celle utilisée par le navigateur.

• Un lien généré sur http://localhost ne fonctionne que sur la même machine.
• Un lien généré sur http://192.168.x.x ne fonctionne que pour les personnes de ce LAN ou VPN.
• Un lien généré sur https://crm.example.com ne fonctionne publiquement que si le DNS, HTTPS, le routage du proxy et le pare-feu sont correctement configurés.
• L’envoi d’e-mails nécessite SMTP. Le téléchargement manuel du PDF et le partage manuel d’un lien public n’en ont pas besoin.

Ressources minimales

Déploiement	RAM	CPU	Disque
Évaluation / usage individuel	2 Go	1 cœur	10 Go SSD
Petite équipe	4 Go	2 cœurs	20 Go SSD
Environnement bêta plus large	8 Go	4 cœurs	50 Go SSD

Ce sont des valeurs de départ prudentes. De grands catalogues, une génération fréquente de PDF, de nombreuses sauvegardes et des images de produits augmentent les besoins en disque et en mémoire.

Les limites des conteneurs, le réglage RAM/CPU et la prévention des manques de mémoire sont décrits dans Ressources système.