> 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-your-mac.md).

# Installer sur ton Mac

Un téléchargement pour Apple silicon et Intel, macOS 13.5 ou plus récent ; mises à jour automatiques.

goodcryptoX pour Mac est une app de la barre des menus, installée en un téléchargement et utilisée dans ton navigateur. Elle se met à jour seule, démarre à l'ouverture de session et trade tant que ton Mac est allumé et connecté.

macOS 13.5 ou ultérieur, Apple silicon ou Intel.

{% hint style="warning" %}
**goodcryptoX trade seulement quand ce Mac est allumé et connecté.** Il surveille ordres et bots tant qu'il tourne. Une courte pause ne pose pas de problème : quelques minutes sans connexion, un redémarrage de l'app ou du Mac, puis goodcryptoX rattrape son retard. Si ce Mac ne reste pas allumé jour et nuit, héberge plutôt goodcryptoX sur un [NAS chez toi](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-nas.md) ou un [serveur loué](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md). Configure-le une fois, étape par étape, puis utilise-le de la même façon depuis navigateur ou téléphone sans craindre un ordre manqué. Tu peux commencer ici et [le déplacer plus tard](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/moving-goodcryptox.md) en un fichier.
{% endhint %}

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

1. [Télécharge goodcryptoX](https://goodcrypto.app/download/mac?utm_source=docs\&utm_medium=page\&utm_campaign=setup-mac) et ouvre le `.dmg`.
2. Glisse **goodcryptoX** sur **Applications**, puis double-clique sur **goodcryptoX** dans la même fenêtre.
3. goodcryptoX apparaît en haut à droite dans la barre des menus et ton navigateur l'ouvre. **Configurer goodcryptoX** sur le Dashboard te guide pour la suite : tes comptes d'exchange, puis ton bot Telegram.

<details>

<summary>Si macOS demande avant de l'ouvrir</summary>

La première fois, macOS indique que goodcryptoX a été téléchargé sur Internet et vérifié par Apple : choisis **Ouvrir**. Une fois suffit. Si une ancienne version est installée, quitte-la d'abord (son menu, **Quit goodcryptoX** (**Quitter goodcryptoX**)) et choisis **Remplacer**. Si ton Mac demande un mot de passe administrateur pour la copie, utilise plutôt le dossier Applications de ton dossier personnel.

</details>

Le point sur l'icône de goodcryptoX dans la barre des menus indique son état : vert, tout va bien ; jaune, quelque chose à vérifier ; rouge, il a besoin de toi maintenant. goodcryptoX démarre à l'ouverture de session et continue navigateur fermé. Avec **Garder le Mac éveillé** activé dans Paramètres › Général › Installation, il empêche un Mac branché de se mettre en veille.

## Autre navigateur <a href="#another-browser" id="another-browser"></a>

Pour utiliser goodcryptoX dans un autre navigateur sur ce Mac, saisis localhost:8118 dans sa barre d'adresse et appuie sur Unlock. Si l'adresse ne s'ouvre pas, choisis Copy sign-in link dans le menu goodcryptoX et colle-le là.

## 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>

Ton téléphone et tes autres ordinateurs se connectent via 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)).

Chez toi, active **Se connecter directement à la maison** dans **Paramètres › Appareils**, puis ouvre son lien sur tes autres appareils ; l'option commence sur **Désactivé**. Si le pare-feu de ton Mac demande si goodcryptoX peut accepter des connexions, autorise-le. [Ton réseau domestique](#your-home-network) te guide.

## 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>

### goodcryptoX trade-t-il quand mon Mac est en veille ? <a href="#does-goodcryptox-trade-while-my-mac-sleeps" id="does-goodcryptox-trade-while-my-mac-sleeps"></a>

Non : il trade seulement quand ce Mac est allumé et connecté, même si les ordres sur l'exchange peuvent toujours s'exécuter. Avec **Garder le Mac éveillé** activé, il empêche un Mac branché de se mettre en veille.

### Sur quels Mac goodcryptoX fonctionne-t-il ? <a href="#which-macs-does-goodcryptox-run-on" id="which-macs-does-goodcryptox-run-on"></a>

macOS 13.5 ou ultérieur, sur Apple silicon ou Intel.

### Puis-je déplacer goodcryptoX de mon Mac plus tard ? <a href="#can-i-move-goodcryptox-from-my-mac-later" id="can-i-move-goodcryptox-from-my-mac-later"></a>

Oui : déplace-le en un fichier vers un [NAS chez toi](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-nas.md) ou un [serveur loué](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md), comptes et bots compris ([Déplacer goodcryptoX](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/moving-goodcryptox.md)).

### Puis-je utiliser goodcryptoX sur mon téléphone ? <a href="#can-i-use-goodcryptox-on-my-phone" id="can-i-use-goodcryptox-on-my-phone"></a>

Oui : ajoute ton téléphone dans 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)).

### Ai-je encore besoin de votre serveur ? <a href="#do-i-still-need-your-server" id="do-i-still-need-your-server"></a>

Non : chez toi, tes appareils ouvrent goodcryptoX directement. Ailleurs, utilise ton propre VPN vers chez toi ou notre serveur ([Accès depuis un téléphone](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/phone-access.md)).
