> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md).

# Installer sur un serveur

Un serveur loué fait tourner goodcryptoX jour et nuit. Configure-le depuis ordinateur ou téléphone, ou déplace ton installation Mac en un fichier.

Un serveur loué fait tourner goodcryptoX jour et nuit. Tu le configures depuis n'importe quel ordinateur, ou ton téléphone seul. Commence ici ou sur Mac, puis déplace-le ici en un fichier.

Tous les fournisseurs conviennent. Pour l'instant, nous recommandons Hostinger : de loin le plus simple à configurer parmi ceux trouvés, et économique aussi. Les étapes montrent ses écrans un par un ; elles fonctionnent chez tout fournisseur cloud, AWS, DigitalOcean, Google Cloud, Azure ou autre.

[**Déployer sur Hostinger**](https://www.hostinger.com/docker-hosting?compose_url=https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml\&REFERRALCODE=HBDNPMHGJLZB)

Le raccourci : ouvre le lien, crée ton compte Hostinger, choisis une offre et suis les écrans. À la fin, goodcryptoX est configuré automatiquement sur le nouveau serveur, sans rien coller. Termine dans le navigateur où tu as ouvert le lien. En cas de problème, le guide ci-dessous fait la même chose à la main.

*Ce lien t'offre 20% de réduction sur ton premier achat, dont goodcryptoX reçoit une part. Tu peux aller sur Hostinger sans ce lien ou choisir un autre fournisseur.*

## Louer un serveur <a href="#rent-a-server" id="rent-a-server"></a>

Tu crées ton compte Hostinger, loues le serveur, y installes goodcryptoX, puis connectes les navigateurs de ton ordinateur et ton téléphone. Voici les étapes.

Les écrans Hostinger tels qu'ils étaient en octobre 2026 :

**1. Inscription.** Aucune carte demandée avant le paiement, quelques écrans plus loin.

**2. Ouvrir VPS › Set up VPS**

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-38aa5d1c8d69ce3fea27b1d23be9814e0607beec%2F01-vps-page.webp?alt=media" alt="Page VPS, flèche sur Set up VPS" width="563"><figcaption></figcaption></figure>

**3. Emplacement.** Choisis la ville la plus proche, puis **Suivant**.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-fa113e868c66fdf3a3db74d607c29c4919a43d68%2F02-location.webp?alt=media" alt="Choix de l&#x27;emplacement, flèche sur Next" width="563"><figcaption></figcaption></figure>

**4. Installation.** Ouvre **Applications** ou cherche « Docker ».

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-b80255526231264fbbb66d2a504934dce0a1b5f1%2F03-choose-what-to-install.webp?alt=media" alt="Choix de l&#x27;installation, flèche sur Applications" width="563"><figcaption></figcaption></figure>

Choisis la tuile **Docker** simple, pas Docker and Traefik, Docker Registry ni Dockge.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-9b6dfd53ca522c9aa49a6d4ab8d67a4762f89aea%2F04-docker-search.webp?alt=media" alt="Recherche Docker, flèche sur la tuile Docker" width="563"><figcaption></figcaption></figure>

Sa carte indique « Installed in Ubuntu 24.04 » : appuie sur **Select**.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-23f7a871be764d6320958c6b2f8386bcd6e43792%2F05-docker-select.webp?alt=media" alt="Carte Docker, flèche sur Select" width="563"><figcaption></figcaption></figure>

**5. Mot de passe root.** Appuie sur **Generate** et conserve le mot de passe dans ton gestionnaire : il ouvre ton serveur. Ignore la clé SSH.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-5c6ba4e6c3b3d2cb26c861180c5700774517968c%2F06-root-password.webp?alt=media" alt="Sécuriser l&#x27;accès VPS, flèche sur Generate" width="563"><figcaption></figcaption></figure>

**6. Fonctions supplémentaires.** Laisse les deux cases vides, puis **Suivant**.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-3f986addd8b40794dff95e85a929a6ce108f640c%2F07-additional-features.webp?alt=media" alt="Fonctions supplémentaires, flèche sur Next" width="563"><figcaption></figcaption></figure>

**7. Offre.** KVM 1 suffit pour goodcryptoX : appuie sur son bouton **Select**.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-340977a7ad685328509fa705c71eecf12550c765%2F08-plan.webp?alt=media" alt="Offres, flèche sur Select de KVM 1" width="563"><figcaption></figcaption></figure>

**8. Période de facturation.** Tu choisis le prix. Le 18 octobre 2026, KVM 1 coûtait $6.49 par mois sur 24 mois, $6.99 sur 12 mois et $9.99 sur 1 mois, hors taxes. Les prix changent ; lis les conditions :

* Le petit prix vaut seulement pour la première période, payée d'avance.
* Ensuite, 12 et 24 mois se renouvellent au tarif normal ($11.99 par mois ce jour-là), 1 mois au plein tarif ($19.49 par mois).
* Tu peux changer la durée plus tard au tarif normal, jamais au tarif de bienvenue.
* Pour tester, prends 1 mois. Pour rester, prends 12 ou 24 mois dès le départ. Si le serveur d'1 mois te convient, loue-en un nouveau sur 12 ou 24 mois, [déplace goodcryptoX dessus](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another) et résilie l'ancien avant son renouvellement.
* Un nouvel achat bénéficie d'une garantie de remboursement de 30 jours.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-9871a3e853d43a044d56e10078b47427db0c5b4c%2F09-billing-period.webp?alt=media" alt="Période de facturation, flèche sur 24 mois" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-6af7e90b53a1c1f216f16cb870aea379699176af%2F09b-billing-1-month.webp?alt=media" alt="Période de 1 mois, renouvellement au plein tarif" width="563"><figcaption></figcaption></figure>

**9. Paiement.** Hostinger prépare ton serveur en environ 5 minutes et t'envoie un e-mail quand il est prêt.

**10. Prêt.** Appuie sur **Manage VPS**. Ignore le domaine gratuit : goodcryptoX n'en a pas besoin.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-74cd99ecc60de9b692d2ece5befcda9e17bf290c%2F11-ready.webp?alt=media" alt="Serveur prêt, flèche sur Manage VPS" width="563"><figcaption></figcaption></figure>

**11. Vue d'ensemble.** Un bref sondage s'ouvre : appuie sur **Skip**, puis **Docker manager** sur la carte Docker.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-106ebc9e276deee724e17a0edfc7fdf098891494%2F13-overview-clean.webp?alt=media" alt="Vue d&#x27;ensemble VPS, flèche sur Docker manager" width="563"><figcaption></figcaption></figure>

<details>

<summary>Chez un autre fournisseur</summary>

Loue un petit serveur avec Ubuntu et Docker, au moins 2 Go de mémoire, dans une région proche. Beaucoup de fournisseurs proposent Ubuntu avec Docker prêt à installer.

</details>

## Démarrer goodcryptoX <a href="#start-goodcryptox" id="start-goodcryptox"></a>

**12. Ouvrir Compose › Compose from URL**

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-cbbd312f6d8085c1c4e4060ba6c5018458778640%2F15-docker-manager.webp?alt=media" alt="Docker Manager, flèche sur Compose" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-f78d8bfd93a506fa7db821902183cf1cb3cd7ac9%2F16-compose-menu.webp?alt=media" alt="Menu Compose, flèche sur Compose from URL" width="563"><figcaption></figcaption></figure>

**13. Lien et nom.** Colle ce lien (le fichier Compose de goodcryptoX sur GitHub, qui utilise l'image la plus récente), nomme l'application `gcx` et appuie sur **Deploy**.

```
https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml
```

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-c5639bb955ce701dbacfd5d76afa19150d2e1af6%2F17b-compose-from-url-filled.webp?alt=media" alt="Compose from URL rempli, flèche sur Deploy" width="563"><figcaption></figcaption></figure>

**14. En cours.** Sous une ou deux minutes, `gcx` affiche **En cours**. Hostinger peut te proposer d'activer HTTPS avec Traefik pour tes applications Docker : goodcryptoX n'en a pas besoin, car le panneau n'ouvre aucun port sur internet ; ferme l'offre.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-9113469ff32d1c7e626325323e1b3753c7de9f48%2F19-running.webp?alt=media" alt="Applications Docker : gcx, Running, flèches sur Terminal et menu de ligne" width="563"><figcaption></figcaption></figure>

<details>

<summary>Si cela ne fonctionne pas</summary>

Deux autres façons.

Le contenu du fichier. Sur Hostinger, choisis **Compose › Compose manually** et colle-le dans l'onglet **.yaml editor**, sous le nom `gcx`. Dans un autre panneau Docker, crée le projet à la main et colle-le.

```yaml
services:
  gcx:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx
    network_mode: host
    init: true
    restart: unless-stopped
    stop_grace_period: 60s
    volumes: [gcx-data:/data, gcx-secret:/secret]
  updater:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx-updater
    entrypoint: [gcx, updater]
    user: "0:0"
    network_mode: none
    init: true
    restart: unless-stopped
    volumes: [/var/run/docker.sock:/var/run/docker.sock, /root/.docker:/docker:ro, gcx-data:/data]
volumes:
  gcx-data: {name: gcx-data}
  gcx-secret: {name: gcx-secret}
```

Un terminal. Ouvre la console web du fournisseur ou `ssh root@<your server's address>` depuis ton ordinateur et lance cette ligne sur le serveur (avec `sudo` avant chaque `docker` si nécessaire). Le journal défile dans la même fenêtre :

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && docker compose up -d && docker logs -f gcx
```

</details>

## Se connecter <a href="#sign-in" id="sign-in"></a>

**15. Journaux.** Sur la ligne `gcx`, ouvre le menu **⋮** (la flèche à droite sur l'image ci-dessus), puis **View logs** et l'onglet **Journaux**.

**16. Lien.** Au premier démarrage, les premières lignes du journal affichent un lien : sélectionne-le et copie-le.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-f463bf2ab9a2f140bd93fe39d4bc38e16b337d18%2F22-logs-link.webp?alt=media" alt="Onglet Logs au premier démarrage, flèche sur le lien" width="563"><figcaption></figcaption></figure>

**17. Ouvrir.** Colle le lien dans le navigateur de ton ordinateur et crée une passkey avec Touch ID, Face ID ou le déverrouillage de l'ordinateur. goodcryptoX s'ouvre sur my.goodcrypto.app ; cette adresse devient ton accès sur cet appareil. Une passkey sauvegardée dans iCloud ou Google fonctionne sur tes autres appareils du même compte. Ajoute les autres dans Paramètres › Appareils › **Ajouter un appareil**. Ton téléphone vient ensuite, depuis le panneau : Paramètres › Appareils › **Ajouter un appareil** affiche un QR code à scanner ([Ajouter un téléphone ou un autre ordinateur](#add-a-phone-or-another-computer)).

Le lien fonctionne une fois : il expire dès qu'un appareil l'utilise, et après 10 minutes. Pour en obtenir un nouveau, appuie sur **Restart** dans le menu de la ligne. Si my.goodcrypto.app affiche « Hors ligne depuis », les 10 minutes du lien sont écoulées et aucun appareil n'est encore associé : obtiens un nouveau lien et ouvre-le dans les 10 minutes. Ce lien est une clé : ne le partage jamais et ne le colle nulle part ailleurs.

Le même appareil ouvre le panneau depuis son favori ou son icône d'accueil et se connecte avec Face ID ou Touch ID, sans lien ni code. C'est la passkey créée à l'association. **Configurer goodcryptoX** sur le Dashboard te guide pour la suite : comptes d'exchange, puis bot Telegram.

<details>

<summary>Ce dont dépend my.goodcrypto.app</summary>

Ton serveur garde une connexion sortante vers le relais goodcryptoX, par lequel my.goodcrypto.app le rejoint : via Internet, sans appel direct. Tout est chiffré entre navigateur et serveur ; le relais transmet et ne peut rien lire ni conserver. Si notre relais disparaît, cette adresse cesse de fonctionner. goodcryptoX continue à tourner et trader sur ton serveur. Le tunnel dans le volet ci-dessous permet alors d'entrer sans rien de notre côté.

</details>

<details>

<summary>Si cela ne fonctionne pas</summary>

Pour scanner plutôt un code sur ton téléphone, ou obtenir autrement un nouveau lien : ouvre le terminal du conteneur (**Terminal** sur la ligne `gcx` chez Hostinger) et lance `gcx pair` (ailleurs, `docker exec gcx gcx pair`). Un terminal dessine un code qui se scanne.

Ou utilise plutôt un tunnel. Sur ton ordinateur, ouvre Terminal (PowerShell sous Windows) et lance cette ligne avec l'adresse du serveur (chez Hostinger, après **IPv4** dans la vue d'ensemble) :

```
ssh -N -L 8128:127.0.0.1:8128 root@<your server's address>
```

Réponds `yes` la première fois, puis saisis le mot de passe du serveur (chez Hostinger, celui de root à l'étape 5). Rien d'autre n'apparaît, c'est normal : garde la fenêtre ouverte pendant l'utilisation. Lance ensuite `gcx open --print` dans le terminal du conteneur (ailleurs, `docker exec gcx gcx open --print`) et ouvre son lien dans ton navigateur sous 60 secondes. goodcryptoX s'ouvre sur `http://localhost:8128/gcx`. Si le journal indique un port autre que 8128, utilise-le des deux côtés de la ligne et dans l'adresse. Se connecter avec Binance fonctionne aussi via le tunnel.

</details>

## Ajouter un téléphone ou un autre ordinateur <a href="#add-a-phone-or-another-computer" id="add-a-phone-or-another-computer"></a>

Une fois ton téléphone ajouté, plus besoin d'ordinateur : tu peux tout gérer depuis celui-ci.

Ajoute un nouveau téléphone ou ordinateur depuis un appareil déjà connecté : Paramètres › Appareils › **Ajouter un appareil** ([Accès depuis un téléphone](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/phone-access.md)).

Il faut revenir au serveur seulement si tous les appareils sont perdus : chez Hostinger, **Terminal** sur la ligne `gcx`, puis `gcx pair` pour un nouveau lien (ailleurs, `docker exec gcx gcx pair`). C'est la récupération ; pas de réinitialisation par e-mail, car tu n'as pas de compte chez nous.

## Sur ton propre réseau <a href="#on-your-own-network" id="on-your-own-network"></a>

Pour un serveur chez toi, goodcryptoX peut aussi s'ouvrir depuis ton portable ou téléphone sans relais : active **Se connecter directement à la maison** dans Paramètres › Appareils, ou lance `gcx network on` dans le Terminal du conteneur (`docker exec gcx gcx network on` ailleurs). L'option reste désactivée jusqu'à ce que tu l'actives. Le fichier compose ci-dessus n'a pas besoin de modification : il utilise le réseau de la machine, donc activer l'interrupteur fait répondre le port à ses adresses sans autre changement ; un pare-feu devant le serveur doit laisser passer ce port. Pour aucun contact avec notre relais, définis `GCX_PHONE_RELAY: ""` sur le service `gcx` avant son premier démarrage. Les étapes et la marche à suivre en cas de perte d'appareil sont dans [Ton réseau domestique](#your-home-network).

Un serveur loué n'est pas un réseau domestique : ses adresses sont exposées à internet. Garde l'interrupteur désactivé et utilise le relais ou le tunnel.

## Mises à jour et sauvegardes <a href="#updates-and-backups" id="updates-and-backups"></a>

goodcryptoX reste à jour seul sur le serveur : une nouvelle version s'installe à un moment calme, comme sur Mac, après les opérations en cours. Paramètres › Général › Installation affiche la version ; **Mettre à jour** en installe une nouvelle immédiatement si tu ne veux pas attendre.

<details>

<summary>Si cela ne fonctionne pas</summary>

Chez Hostinger, choisis **Mettre à jour** dans le menu de la ligne `gcx` ; ailleurs, lance `docker compose pull && docker compose up -d` dans le dossier de `compose.yaml`.

</details>

goodcryptoX garde tes données dans deux volumes Docker, `gcx-data` et `gcx-secret`. Sauvegarde-les ensemble : `gcx-data` seul ne peut pas ouvrir tes clés.

## Serveurs gratuits ou économiques <a href="#free-and-low-cost-servers" id="free-and-low-cost-servers"></a>

Les serveurs économiques, voire gratuits, peuvent faire tourner goodcryptoX. Le serveur Arm Always Free d'Oracle Cloud a assez de mémoire, mais les capacités gratuites sont parfois difficiles à obtenir et Oracle peut récupérer un serveur peu utilisé. À envisager si tu as déjà un compte Oracle ; pour débuter au plus simple, Hostinger reste le plus facile parmi ceux trouvés.

### Utiliser Oracle Cloud Always Free <a href="#oracle-cloud-always-free" id="oracle-cloud-always-free"></a>

Choisis **Ampere A1**, **Ubuntu**, **1 OCPU et 2 Go de mémoire**. L'image Docker de goodcryptoX fonctionne sur Arm et Intel/AMD sans changer les commandes. Évite l'AMD micro gratuit : son 1 Go de mémoire laisse trop peu de place pour Ubuntu et goodcryptoX ensemble.

L'[allocation gratuite actuelle](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier_topic-Always_Free_Resources.htm) d'Oracle, vérifiée le 22 octobre 2026, couvre ce serveur. Vérifie la mention gratuit et l'estimation avant de créer quoi que ce soit. Le crédit d'essai limité dans le temps est une autre offre.

Avant de choisir Oracle :

* L'inscription exige une carte de crédit ou de débit compatible et peut réserver temporairement un montant ; [contacte Oracle](https://www.oracle.com/cloud/free/faq/) si la vérification échoue.
* Choisis ta [région d'origine](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingregions.htm) avec soin : les serveurs gratuits doivent y être et elle ne peut pas changer.
* Si aucun serveur gratuit n'est disponible, essaie un autre domaine de disponibilité de la région ou réessaie plus tard.
* Oracle peut récupérer un serveur peu utilisé même en marche ; [sauvegarde les deux volumes goodcryptoX](#updates-and-backups) et prévois des interruptions.
* Passer à une offre supérieure garde l'allocation gratuite mais autorise une facturation au-delà ; ne le fais pas seulement pour éviter la récupération.
* Oracle peut [suspendre ou fermer un compte inactif pendant 30 jours](https://www.oracle.com/cloud/free/faq/) ; vérifie régulièrement ses messages et ton serveur.

### Configurer Oracle <a href="#oracle-setup" id="oracle-setup"></a>

Ces étapes suivent la documentation Oracle ; le parcours illustré et les captures attendent un compte Oracle vérifié.

**1. Connexion.** Ouvre [Oracle Cloud](https://cloud.oracle.com/) avec ton compte cloud. Pour un nouveau compte, pars de la [page Free Tier d'Oracle](https://www.oracle.com/cloud/free/).

**2. Créer le serveur.** Suis le [guide de serveur Linux d'Oracle](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm) : **Compute › Instances › Create instance**. Choisis Ubuntu, puis la forme **VM.Standard.A1.Flex** avec **1 OCPU et 2 Go**. Garde le disque de démarrage dans l'allocation gratuite et sauvegarde la clé SSH proposée. La clé privée ouvre ton serveur : garde-la secrète.

**3. Vérifier le réseau.** Le serveur a besoin d'une adresse publique et d'un accès SSH. Autorise SSH (TCP 22) depuis l'IP publique de ton ordinateur. Aucun autre port entrant n'est nécessaire pour goodcryptoX : utilise le tunnel privé ci-dessous ou le lien de [Se connecter](#sign-in). N'ouvre pas le port 8128 à Internet.

**4. Se connecter.** Sur ton ordinateur, ouvre Terminal ou PowerShell sous Windows. Remplace les deux paramètres par le fichier de clé sauvegardé et l'adresse publique du serveur. Sur macOS ou Linux, lance d'abord `chmod 400 <your-private-key-file>` ; sur Windows, suis les [étapes Oracle pour les droits de la clé](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm) :

```
ssh -i <your-private-key-file> ubuntu@<your-server-address>
```

**5. Installer Docker si nécessaire.** Dans ce terminal serveur, suis l'[installation Ubuntu de Docker](https://docs.docker.com/engine/install/ubuntu/) avec son dépôt apt, et installe aussi son plugin Compose. Les mêmes instructions couvrent Arm et Intel/AMD. Vérifie que `sudo docker compose version` affiche une version.

**6. Démarrer goodcryptoX.** Exécute ceci sur le serveur :

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && sudo docker compose up -d && sudo docker logs -f gcx
```

**7. Ouvrir le panneau.** Utilise le lien du journal comme dans [Se connecter](#sign-in).

<details>

<summary>Utiliser plutôt un tunnel SSH</summary>

Garde ceci en cours dans un second terminal sur ton ordinateur :

```
ssh -i <your-private-key-file> -N -L 8128:127.0.0.1:8128 ubuntu@<your-server-address>
```

Puis lance `sudo docker exec gcx gcx open --print` sur le serveur et ouvre son lien sous 60 secondes. Si le journal indique un autre port, utilise-le des deux côtés du tunnel. Ne partage jamais le lien de connexion.

</details>

### Autres petits serveurs <a href="#other-small-servers" id="other-small-servers"></a>

Prix publiés vérifiés le 22 octobre 2026 ; devise, taxes, région, durée et renouvellement comptent. Lis le prix final avant de payer. Ces fournisseurs n'ont pas encore fait l'objet du parcours goodcryptoX écran par écran ci-dessus.

| Serveur                                                             | Prix publié                                                      | À vérifier                                                                                                                |
| ------------------------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| [netcup VPS nano G11.5s](https://www.netcup.com/de/server/vps-lite) | €3.69/mois, TVA de 19% incluse, engagement de six mois           | 2 Go de mémoire, 60 Go de disque ; Nuremberg seulement. Le prix varie selon le pays fiscal ; choisis la connectivité IPv4 |
| [OVHcloud VPS-1](https://www.ovhcloud.com/en/vps/)                  | Dès US$4.54/mois                                                 | 4 Go de mémoire, 40 Go de disque. Prix de départ ; confirme durée, taxes, région et renouvellement à la commande          |
| [IONOS VPS S+](https://www.ionos.com/servers/vps)                   | US$2/mois pendant trois mois, puis US$6/mois, engagement d'un an | 2 Go de mémoire, 60 Go de disque ; le prix de bienvenue ne dure pas l'année                                               |

## Utiliser un proxy <a href="#proxy" id="proxy"></a>

Un proxy fait passer chaque connexion d'exchange par l'adresse de ton choix, sur ordinateur, NAS ou serveur.

Ouvre **Paramètres › Général › Confidentialité et sécurité › Serveur proxy**, active **Proxy activé**, saisis `socks5://host:port` ou `http://host:port` et appuie sur **Enregistrer**. Sans adresse enregistrée, Enregistrer l'active. Avec une adresse, l'interrupteur enregistre immédiatement ; désactiver garde l'adresse pour plus tard. Le mot de passe est masqué dans l'adresse enregistrée. **Modifier** l'ouvre avec **Enregistrer** et **Annuler** ; **Retirer** l'efface et désactive le proxy. Un champ vide ne montre aucun avertissement ; une adresse autre que SOCKS5 ou HTTP affiche un avertissement après Enregistrer et n'est pas sauvegardée. Si le proxy exige un identifiant, utilise `socks5://user:password@host:port` ou `http://user:password@host:port` ; encode les caractères spéciaux (par exemple `@` en `%40`). Utilise un proxy de confiance. Les flux d'exchange existants se reconnectent par lui sans redémarrer goodcryptoX. En cas de panne du proxy, goodcryptoX t'alerte : vérifie adresse et identifiants ou désactive le proxy pour une connexion directe.

Pour une installation en terminal ou Docker, définis `GCX_PROXY=socks5://host:port` (ou l'adresse HTTP) dans son environnement avant de démarrer goodcryptoX. Dès que tu enregistres le proxy dans les paramètres, ce choix prime sur l'environnement, même désactivé. Le proxy couvre les exchanges ; relais, rapports, mises à jour et autres services de goodcryptoX se connectent directement.

Sur serveur ou NAS, tu peux utiliser un VPN via un conteneur Gluetun auxiliaire : ajoute le service ci-dessous au fichier Compose existant, renseigne ton fournisseur VPN et garde `network_mode: host` pour goodcryptoX. Seul Gluetun utilise le VPN ; les services de goodcryptoX restent directs. Démarre le projet modifié, puis enregistre `http://127.0.0.1:8888` dans Proxy (ou définis `GCX_PROXY` sur le service `gcx`). Le port du proxy n'est accessible que sur cette machine. Le fournisseur VPN doit accepter tes identifiants OpenVPN ; un NAS doit disposer de `/dev/net/tun` et autoriser la capacité `NET_ADMIN`.

```yaml
  gluetun:
    image: qmcgaw/gluetun:latest
    cap_add: [NET_ADMIN]
    devices: [/dev/net/tun:/dev/net/tun]
    environment:
      VPN_SERVICE_PROVIDER: <your-vpn-provider>
      VPN_TYPE: openvpn
      OPENVPN_USER: <your-vpn-user>
      OPENVPN_PASSWORD: <your-vpn-password>
      HTTPPROXY: "on"
    ports: ["127.0.0.1:8888:8888/tcp"]
    restart: unless-stopped
```

### Ton réseau domestique <a href="#your-home-network" id="your-home-network"></a>

goodcryptoX peut s'ouvrir directement sur ton réseau domestique, sans notre serveur : active un interrupteur et la page affiche un lien. Ouvre ce lien sur n'importe quel appareil à la maison et goodcryptoX est là. L'option reste désactivée jusqu'à ce que tu l'actives, sur Mac, Windows, Linux, NAS ou serveur.

#### L'activer <a href="#turn-it-on" id="turn-it-on"></a>

1. Ouvre goodcryptoX comme d'habitude : sur la machine, via my.goodcrypto.app ou avec le lien affiché par l'installation. Tu peux le faire de n'importe où, même depuis un téléphone hors de chez toi.
2. Ouvre **Paramètres › Appareils** et active **Se connecter directement à la maison**, dans la carte **Réseau domestique** en bas.
3. La carte affiche un lien et son code QR : « Ouvre ce lien ou scanne le code QR sur n'importe quel appareil de ton réseau domestique ».

Le lien reste le même jusqu'à ce que tu désactives l'interrupteur. Garde-le là où tu gardes tes affaires : dans ton navigateur, dans une note ou dans un message à toi-même.

Si le pare-feu demande si goodcryptoX peut accepter des connexions, ou le bloque, autorise-le.

#### Connecter un appareil <a href="#connect-a-device" id="connect-a-device"></a>

Ouvre ce lien ou scanne le code QR sur n'importe quel appareil de ton réseau domestique. Clique sur le texte du lien ou sur **Copier** pour le copier, puis colle-le dans le navigateur de cet appareil ; sur un téléphone, tu peux scanner le code QR avec l'appareil photo. goodcryptoX s'ouvre et l'appareil est connecté. Fais de même sur chaque appareil à la maison.

L'appareil ouvre ensuite goodcryptoX à cette adresse depuis l'historique du navigateur ou depuis le même lien : un appareil déjà connecté l'ouvre sans autre étape ni nouvelle ligne dans Appareils.

Sur un Mac ou un iPhone, le navigateur peut d'abord demander s'il peut rechercher des appareils sur ton réseau local : autorise-le. Si la page indique que l'adresse est inaccessible, active le navigateur dans Réglages Système › Confidentialité et sécurité › Réseau local (sur un iPhone : Réglages › le navigateur › Réseau local) et recharge la page.

#### Sur un NAS ou un serveur <a href="#on-a-nas-or-a-server" id="on-a-nas-or-a-server"></a>

Via my.goodcrypto.app, tu l'actives dans Paramètres › Appareils, comme ci-dessus. Sans contact avec notre serveur, ou tant qu'aucun appareil n'est connecté, le journal de la machine indique comment faire à chaque démarrage : « Se connecter directement à la maison : gcx network on dans le Terminal du conteneur, ou docker exec gcx gcx network on ».

1. Ouvre le Terminal du conteneur (sur NAS, le conteneur `gcx` dans Container Manager ; sur serveur, la console de ton fournisseur).
2. Lance `gcx network on` (depuis le shell de la machine : `sudo docker exec gcx gcx network on`). La commande affiche un lien et son QR code.
3. Copie le lien et ouvre-le dans le navigateur de ton portable.

Tant qu'aucun appareil n'est connecté, le journal affiche le même lien à chaque démarrage. Le lien est une clé : toute personne qui lit le journal du conteneur peut le voir, alors garde le journal pour toi.

Si l'adresse proposée n'est pas celle que ton portable atteint, donne-la toi-même : `gcx network on http://192.168.1.20:8128`, avec l'adresse de ta machine et le port affiché par goodcryptoX. La commande liste aussi les autres adresses de la machine pour choisir.

Un goodcryptoX qui tourne comme service sur un ordinateur sans écran (hors Docker) n'affiche pas cette ligne au démarrage : lance `gcx network on` dans son shell.

* `gcx network` indique si l'option est activée, à quelles adresses, et affiche le lien.
* `gcx network off` la désactive.
* **Aucun contact avec notre serveur :** définis `GCX_PHONE_RELAY: ""` sur le service `gcx` du fichier compose avant son premier démarrage. Une fois goodcryptoX démarré avec notre serveur, activer l'interrupteur n'annule pas ce premier contact. Avec notre serveur désactivé, **Ajouter un appareil** ne s'affiche pas : le lien domestique permet d'entrer.
* **Le fichier compose fourni** (réseau de la machine) n'a pas besoin d'être modifié pour l'interrupteur. Désactivé, goodcryptoX répond seulement sur la machine elle-même, comme avant ; activé, à ses adresses. Un pare-feu devant le NAS ou serveur doit laisser passer le port.

#### Qui peut l'ouvrir <a href="#who-can-open-it" id="who-can-open-it"></a>

Active cette option chez toi, sur un réseau de confiance. Ne redirige pas le port sur ton routeur.

Toute personne qui a ce lien et se trouve sur ton réseau peut ajouter un appareil tant que l'option est activée. Le lien fonctionne partout où il a été affiché ou envoyé : capture d'écran, discussion, journal de la machine. Tu vois chaque appareil dans **Paramètres › Appareils** : retire ceux que tu n'as pas ajoutés. Pour invalider le lien lui-même, désactive puis réactive l'interrupteur : cela crée un nouveau lien et l'ancien cesse de fonctionner. Les appareils déjà ajoutés ouvrent à nouveau goodcryptoX à la réactivation, jusqu'à ce que tu les retires.

Toute autre personne qui ouvre l'adresse ne voit que le logo et « Pour ouvrir goodcryptoX dans ce navigateur, utilise le lien de la maison disponible dans Paramètres › Appareils sur un appareil où goodcryptoX est ouvert. »

Si tu perds un appareil ou soupçonnes un autre accès : retire l'appareil, désactive puis réactive l'interrupteur pour un nouveau lien, puis vérifie Appareils et retire ceux que tu n'as pas ajoutés ; révoque les clés créées entre-temps et toute clé qui a pu être copiée.

Un appareil ajouté ici peut faire tout ce que tu fais sur ton ordinateur, trading et modification des paramètres compris, sauf si tu le règles sur **Lecture seule**. Un appareil en Lecture seule voit l'adresse, jamais le lien. HTTP transporte la page, le lien et la connexion en clair : quelqu'un qui peut lire le trafic de ton réseau peut les copier ; ta propre adresse HTTPS protège contre cela.

#### Sur un portable <a href="#on-a-laptop" id="on-a-laptop"></a>

Sur un portable, l'activation de **Se connecter directement à la maison** affiche d'abord un avertissement : choisis **Activer** pour continuer ou **Annuler** pour laisser l'option désactivée. Cette fenêtre apparaît uniquement sur un portable. Tant que l'option est activée, la carte garde le même texte en gris discret près de l'interrupteur : « Sur chaque réseau Wi-Fi auquel MacBook-Pro se connecte, toute personne connectée à ce réseau peut ouvrir goodcryptoX avec ce lien », avec le nom de ta machine. Le réseau domestique est le Wi-Fi auquel le portable est connecté, même celui d'un café ou d'un hôtel : toute personne sur ce réseau qui a le lien peut ajouter un appareil. Désactive l'option avant de quitter la maison, ou garde le lien pour toi. goodcryptoX reconnaît un portable par sa batterie ou son boîtier ; il ne peut pas le savoir depuis Docker (Docker Desktop sur un portable n'affiche aucune ligne), et n'en affiche pas non plus si la lecture échoue.

#### Ce que signifie « réseau domestique » <a href="#what-home-network-means" id="what-home-network-means"></a>

goodcryptoX répond aux appareils des réseaux auxquels ta machine est connectée et de ton propre VPN vers chez toi ; il refuse le reste d'internet. Cette vérification fait au mieux, ce n'est pas un verrou : un proxy, un VPN ou un routeur qui transfère le trafic peut la passer, et la connexion par laquelle un VPN envoie ton trafic n'est pas ton réseau domestique. goodcryptoX ne sait pas sur quel Wi-Fi un appareil se trouve et ne distingue pas un invité d'un membre de la famille. Ce sont le lien et les appareils que tu gardes qui tiennent les autres à l'écart.

#### Ta propre adresse <a href="#your-own-address" id="your-own-address"></a>

Si tu atteins déjà ta machine par un nom à toi, via ton propre proxy HTTPS (Caddy, nginx), indique-le sur la machine : `gcx network on https://gcx.example.com`. goodcryptoX l'enregistre, active l'interrupteur et affiche le lien à cette adresse. Un nom garde aussi tes appareils connectés quand l'adresse de la machine change. HTTPS à la maison sans ton propre proxy est prévu pour une version ultérieure.

<details>

<summary>Paramètres du proxy</summary>

La configuration par défaut de Caddy fonctionne :

```caddyfile
gcx.example.com {
    reverse_proxy 127.0.0.1:8128
}
```

nginx doit conserver le Host du navigateur et transmettre les WebSockets ; les lignes habituelles `X-Forwarded-*` peuvent rester. Mets la map dans le bloc `http` de nginx et la location dans ton serveur HTTPS existant pour ce nom :

```nginx
map $http_upgrade $gcx_connection {
    default upgrade;
    '' close;
}
location / {
    proxy_pass http://127.0.0.1:8128;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $gcx_connection;
}
```

Utilise le port affiché par goodcryptoX à la place de 8128. Si une page indique « Cette adresse n'est pas disponible », le proxy a modifié le Host : garde-le tel que le navigateur l'a envoyé.

Un proxy sur cette machine qui transmet à goodcryptoX une adresse `localhost` y accède comme la machine elle-même, et désactiver l'interrupteur ne le bloque pas : restreins ou supprime ce proxy toi-même.

</details>

#### Tes appareils <a href="#your-devices" id="your-devices"></a>

* Chaque appareil ajouté ainsi a sa ligne dans **Paramètres › Appareils**, marquée **Réseau domestique**, avec **Peut trader** ou **Lecture seule** et **Retirer**. Supprimer coupe l'accès immédiatement.
* Un appareil inutilisé pendant 90 jours doit être ajouté à nouveau. Un appareil utilisé reste connecté. Ton navigateur garde sa connexion pour l'adresse où il a été ajouté : la même machine à une autre adresse (un nom au lieu d'un nombre) doit donc être ajoutée à nouveau ; le navigateur peut aussi l'oublier plus tôt si tu effaces ses données.
* Un téléphone qui utilise notre serveur (ailleurs) et le lien domestique (chez toi) a deux lignes : une par accès. Retirer supprime la ligne sur laquelle tu appuies.
* Désactiver l'interrupteur ferme goodcryptoX à tous les appareils du réseau domestique ; leurs lignes restent et le réactiver les laisse entrer. Les appareils qui utilisent notre serveur ne sont pas affectés (Accès depuis un téléphone).
* Hors de chez toi, connecte-toi à ton propre VPN vers ton réseau domestique et ouvre la même adresse, ou utilise notre serveur (Accès depuis un téléphone).
* Se connecter avec Binance fonctionne à ton adresse sur le réseau domestique, comme 192.168.1.20. À ta propre adresse (un nom), utilise une clé API autogénérée.

#### Connecter un wallet à cette adresse <a href="#connect-a-wallet-at-this-address" id="connect-a-wallet-at-this-address"></a>

Un wallet se connecte à l'adresse domestique comme ailleurs : une extension de wallet dans ton navigateur (MetaMask, Rabby et autres), ou un wallet mobile en scannant le code QR. Ouvrir la fenêtre du wallet envoie à Reown / WalletConnect l'adresse de la page, y compris celle de ton réseau domestique (voir la politique de confidentialité). Le code QR nécessite que leurs serveurs soient joignables.

Un wallet ne chiffre pas ta connexion à goodcryptoX : à l'adresse domestique, elle reste en HTTP non chiffré. Si tu ne fais pas confiance à ce réseau, utilise [ta propre adresse](#your-own-address) en HTTPS, ou ouvre goodcryptoX via notre serveur (Accès depuis le téléphone).

Si le service de wallets refuse un jour cette adresse, la fenêtre se ferme et une ligne sous **Connecter le wallet** indique quoi faire : « Les portefeuilles mobiles ne peuvent pas se connecter à cette adresse. Utilise une extension de portefeuille dans ce navigateur, ou ouvre cette page dans le navigateur de l'app de ton portefeuille ». **Autres moyens** ajoute goodcryptoX via notre serveur ou un tunnel SSH. Jusqu'au rechargement de la page, la fenêtre liste uniquement les wallets de ton navigateur ; sans extension, Connecter le wallet indique « Aucune extension de wallet dans ce navigateur ».

#### En cas de problème <a href="#if-something-goes-wrong" id="if-something-goes-wrong"></a>

* **Le lien ne fonctionne plus :** l'interrupteur a été désactivé et sa réactivation a créé un nouveau lien. Ouvre le nouveau depuis **Paramètres › Appareils** sur un appareil connecté, ou lance `gcx network` sur la machine.
* **La page affiche « Pour ouvrir goodcryptoX dans ce navigateur, utilise le lien de la maison disponible dans Paramètres › Appareils sur un appareil où goodcryptoX est ouvert. »** L'appareil n'est pas ajouté : il a été retiré, inutilisé pendant 90 jours ou oublié par son navigateur. Ouvre à nouveau le lien.
* **Tous les appareils sont perdus :** dans la console de la machine, lance `gcx network` (`gcx network on` si l'interrupteur est désactivé) et ouvre le lien affiché. Il n'y a pas de réinitialisation par e-mail.
* **L'adresse a changé** (un routeur peut en attribuer une autre) **ou les données du navigateur ont été effacées :** ouvre à nouveau le lien depuis **Paramètres › Appareils** : il contient la nouvelle adresse. [Ta propre adresse](#your-own-address) évite le premier cas.
* **La carte indique « goodcryptoX est verrouillé » :** déverrouille d'abord goodcryptoX ; le lien réapparaît. Les appareils déjà ajoutés et le lien lui-même continuent de fonctionner entre-temps.
* **Après avoir déplacé goodcryptoX avec Importer** depuis un appareil ouvert sur le réseau domestique : la nouvelle machine démarre avec l'interrupteur désactivé, sans appareils du réseau domestique ni lien, donc cet appareil perd l'accès à goodcryptoX au redémarrage. Active l'interrupteur sur la nouvelle machine et ouvre son nouveau lien.

## Questions fréquentes <a href="#questions" id="questions"></a>

### Combien ça coûte ? <a href="#what-does-it-cost" id="what-does-it-cost"></a>

Tu paies le serveur : le 18 octobre 2026, KVM 1 de Hostinger coûtait $6.49 par mois sur 24 mois payés d'avance, hors taxes. Des serveurs économiques, voire gratuits, peuvent aussi héberger goodcryptoX. goodcryptoX lui-même est gratuit à utiliser ; seuls frais : 0.03% par trade exécuté qu'il place pour toi (au spot, par vente).

### goodcryptoX sur serveur trade-t-il quand mon ordinateur est éteint ? <a href="#does-goodcryptox-on-a-server-trade-while-my-computer-is-off" id="does-goodcryptox-on-a-server-trade-while-my-computer-is-off"></a>

Oui : le serveur fait tourner goodcryptoX jour et nuit. Une fois ton téléphone ajouté, tu peux tout gérer depuis celui-ci sans ordinateur.

### Quel fournisseur de serveur choisir ? <a href="#which-server-provider-should-i-use" id="which-server-provider-should-i-use"></a>

Tous conviennent : les étapes montrent Hostinger, le plus simple parmi ceux trouvés. Elles fonctionnent aussi chez AWS, DigitalOcean, Google Cloud, Azure ou tout autre.

### Ai-je besoin d'un domaine ? <a href="#do-i-need-a-domain" id="do-i-need-a-domain"></a>

Non : goodcryptoX n'en a pas besoin et tu l'ouvres sur my.goodcrypto.app.

### Où sont mes données ? <a href="#where-is-my-data" id="where-is-my-data"></a>

Dans deux volumes Docker sur le serveur, `gcx-data` et `gcx-secret` : sauvegarde-les ensemble, car `gcx-data` seul ne peut pas ouvrir tes clés.

### Puis-je déplacer goodcryptoX sur un autre serveur plus tard ? <a href="#can-i-move-goodcryptox-to-another-server-later" id="can-i-move-goodcryptox-to-another-server-later"></a>

Oui : exporte sur l'ancien serveur avec `sudo docker exec -it gcx gcx export` dans son terminal, copie le fichier sur ton ordinateur, puis utilise **Importer** dans le panneau du nouveau, comptes et bots compris ([Déplacer goodcryptoX](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another)).
