Tutoriel VPS, installation et configuration

Ce que tu obtiendras

Une console HTTPS fonctionnelle et un compte administrateur sécurisé.

1. Obtiens un VPS Linux

Dans le panneau de ton hébergeur, crée un nouveau VPS Linux x86-64 avec accès root. Ubuntu 24.04 LTS ou Debian 12+ sont des choix simples. Utilise une version de système d'exploitation maintenue ; ARM n'est pas couvert par l'installateur natif.

Pour une petite boutique, commence avec 2 vCPU, 4 GB de RAM et 60 GB SSD. Un usage léger peut fonctionner avec 1 vCPU, 2 GB de RAM et 20 GB de disque, mais prévois de la place pour le système, l'historique des paiements, les sauvegardes et mises à jour. Ce serveur n'exécute pas de nœuds blockchain.

Ajoute ta clé publique SSH, note l'IP du serveur et vérifie son empreinte d'hôte SSH à la première connexion. Ne partage jamais une clé SSH privée. Consulte les exigences complètes ou l' installation Docker facultative.

2. Fais pointer tes domaines vers le serveur

Dans le panneau DNS de ton domaine, ajoute ces enregistrements. Remplace example.com et l'IP par les tiens.

Nom d'hôte	Enregistrement	Fonction
merchant.example.com	A → IPv4 du VPS	Ta console
pay.example.com	A → IPv4 du VPS	Page de paiement client
api.example.com	A → IPv4 du VPS	Tes intégrations

Les noms de sous-domaines personnalisés conviennent ; l'installateur te les demande. Ajoute des enregistrements AAAA uniquement si IPv6 atteint réellement ce VPS. Un ancien enregistrement AAAA peut faire échouer la validation HTTPS même si l'enregistrement A est correct.

Cloudflare : désactive le proxy (DNS uniquement) pendant l'installation. Une fois la configuration et la validation HTTPS terminées, tu peux le réactiver. Utilise une connexion chiffrée vers l'origine, idéalement Full (strict) avec le certificat valide.

3. Vérifie le pare-feu

Autorise en entrée TCP 80 et 443 dans le pare-feu du VPS comme dans celui de l'hébergeur. Garde ton véritable port SSH ouvert. HTTPS et DNS sortants doivent fonctionner.

N'expose pas PostgreSQL ni les ports internes de l'application. L'installateur ne modifie pas les règles du pare-feu pour toi. Garde ta session SSH actuelle ouverte pendant la modification des règles d'accès pour ne pas te verrouiller dehors.

4. Exécute l'installateur signé

Connecte-toi par SSH en root et exécute :

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)

La configuration demande tes domaines, l'email de contact HTTPS, la devise fiat par défaut et le nom d'utilisateur/mot de passe HTTP Basic. Tu peux choisir ce mot de passe ou le faire générer. Conserve-le en sécurité.

L'installateur vérifie la version signée et configure PostgreSQL, Nginx, HTTPS et les services système. Attends son message de réussite. Les identifiants Basic Auth constituent une couche de sécurité distincte, pas ton futur compte console.

Vérifie d'abord ou reprends une installation interrompue

Exécute la vérification de compatibilité avant d'installer :

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --check

Corrige l'erreur signalée, puis reprends. Ne supprime pas le répertoire d'installation et ne régénère pas les clés des portefeuilles.

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume

5. Inscris-toi et sécurise ton compte

Ouvre ton nom d'hôte merchant, passe Basic Auth et inscris le premier administrateur avec un email et un mot de passe fort. Choisis le mode d'installation, la langue et le fuseau horaire, puis consulte les conditions et la politique de confidentialité liées. Le choix du mode est permanent. Consulte les Mode commerçant ou opérateur avant de valider.

Dans Réglages → Compte, active l'authentification à deux facteurs. Dans Réglages → Système, vérifie les valeurs régionales par défaut de devise/fuseau horaire et les domaines actifs. Ces valeurs concernent les nouveaux éléments ; elles ne réécrivent pas les projets existants.

La première installation éligible reçoit une seule fois un crédit de bienvenue de 10 USD automatiquement après l'inscription et la connexion. Consulte Réglages → Frais pour le statut de facturation. Comprendre les crédits de traitement →

6. Vérifie avant d'accepter des paiements

Ouvre Réglages → Connexions blockchain. Regarde la disponibilité du scanner, pas seulement la santé des nœuds. Garde des fournisseurs de repli indépendants pour les blockchains que tu utiliseras.

Protège-le comme un serveur de portefeuilles chauds : restreins l'accès administrateur, installe les mises à jour de sécurité et garde des sauvegardes privées hors du VPS. Un export de portefeuille contient des secrets ; ne l'importe jamais sur un site ou dans un ticket d'assistance. Liste de contrôle de sécurité du serveur →

Tu es prêt à créer un projet et un magasin. Fais un petit test réel de chaque moyen de paiement avant de le proposer aux clients.