# Routeur Connext - guide d'installation

By [Oozman](https://paragraph.com/@oozman) · 2022-05-17

---

![https://www.connext.network/](https://storage.googleapis.com/papyrus_images/ce0a6fb3011b3c41efccd36ab2cf47d68e22450ae2bb787c8ab28a5274d4197e.png)

https://www.connext.network/

Guide de paramétrage d’un routeur Connext rédigé dans le cadre du Contributor Program.

Documentation officielle en anglais :

> [Spinning Up a Router](https://docs.connext.network/routers/spinning-up)

Note: ce guide propose une première prise en main du router. Le routeur est entièrement basé sur Docker. Il peut donc être exécuté sous plusieurs types de configurations comme Kubernetes, AWS Elastic Container Service, ou des alternatives similaires.

Configuration matérielle minimum
--------------------------------

*   8GB de RAM
    
*   30GB d’espace disque
    
*   Redis
    

Configuration logicielle mininum
--------------------------------

*   [Docker CE (Community Edition)](https://docs.docker.com/install/) version 20.10.5 ou ultérieure.
    
*   [Docker Compose](https://docs.docker.com/compose/install/) version 1.27.4 ou ultérieure.
    

Cloner l’archive
----------------

Pour faire tourner le routeur, commencez par cloner l’archive `nxtp-router-docker-compose` et basculez sur la branche `amarok`.

    git clone https://github.com/connext/nxtp-router-docker-compose.git
    cd nxtp-router-docker-compose/
    git checkout amarok
    

Configuration de base
---------------------

Créez un fichier `.env` sur l’exemple de `.env.example`

    mv .env.example .env
    
    nano .env
    

Le fichier devrait ressembler à ceci:

    ################################################################################
    
    General configuration
    
    ROUTER_VERSION=latest
    
    ROUTER_EXTERNAL_PORT=8000
    GRAFANA_EXTERNAL_PORT=3008
    WEB3SIGNER_HTTP_LISTEN_PORT=9000
    
    ################################################################################
    
    Monitoring configuration
    
    LOGDNA_KEY=
    LOGDNA_TAG=
    
    DISCORD_WEBHOOK=
    

Modifiez les variables d’environnement :

*   `ROUTER_VERSION` - La version du routeur à utiliser (par ex: `v0.1.0`). Voir [ici](https://github.com/connext/nxtp/releases) pour les informations sur les dernières versions.
    
*   `ROUTER_EXTERNAL_PORT` - Port ouvert du routeur. Ne pas ouvrir ce port au public.
    
*   `GRAFANA_EXTERNAL_PORT` - Port ouvert de la console Grafana (facultatif).
    
*   `LOGDNA_KEY` - Cette clé est utilisée par le conteneur logDNA (facultatif). Vous pouvez l’obtenir [ici](https://app.logdna.com/account/signin).
    

![https://www.logdna.com/](https://storage.googleapis.com/papyrus_images/5f3ba87a1828ada36b147dc4d1394d1363fb041c2d958c911395fbf5a2e5cf44.png)

https://www.logdna.com/

### Configuration de Redis

Par défaut, le routeur utilise une instance de Redis interne à Docker. Si vous préférez utiliser votre instance Redis externe, vous pouvez paramétrer les champs `host` et `port` correspondant dans `config.json`. Plus d’informations sur le site de [Redis](https://redis.io/).

### Configuration de Web3Signer

Paramétrez les fichiers config de [Web3Signer](https://docs.web3signer.consensys.net/en/latest/) pour une utilisation sécurisée de la clé. Créez un fichier `key.yaml` sur l’exemple de `key.example.yaml` :

    mv key.example.yaml key.yaml
    
    nano ~/nxtp-router-docker-compose/key.yaml
    

Ajoutez votre clé privée dans le champs `privateKey` de `key.yaml`.

    type: "file-raw"
    keyType: "SECP256K1"
    privateKey: "c41a12b71d297b7bea5be41f4b752"
    

### Configuration du routeur

Créez un fichier `config.json` sur l’exemple de `config.example.json`.

    nano ~/nxtp-router-docker-compose/config.json
    

Changez au moins les valeurs suivantes :

*   `sequencerUrl` - L’URL du noeud séquenceur.
    
*   `redis` - L’instance Redis à utiliser.
    
*   `server` - Configuration du serveur HTTP interne (`adminToken`).
    
*   `chains` - Ajouter les chains, actifs, et URLs de fournisseurs désirés. Utilisez des mappings de `domain` au lieu de `chainIds`. Pour plus d’information sur les id de chains, consultez [https://raw.githubusercontent.com/connext/chaindata/main/crossChain.json](https://raw.githubusercontent.com/connext/chaindata/main/crossChain.json) . Utilisez plusieurs fournisseurs pour chaque chain ! Exemple avec les actifs de testnet actuels:
    

    {
      "chains": {
        "1111": {
          "assets": [
            {
              "address": "0xB7b1d3cC52E658922b2aF00c5729001ceA98142C",
              "name": "TEST"
            }
          ],
          "providers": ["https://eth-rinkeby.alchemyapi.io/v2/.....", "https://rpc.ankr.com/eth_rinkeby"]
        },
        "2221": {
          "assets": [
            {
              "address": "0xB5AabB55385bfBe31D627E2A717a7B189ddA4F8F",
              "name": "TEST"
            }
          ],
          "providers": ["https://eth-kovan.alchemyapi.io/v2/....."]
        }
      },
      "logLevel": "debug",
      "mnemonic": "",
      "sequencerUrl": "https://sequencer.testnet.connext.ninja",
      "server": { "adminToken": "blahblahblah" },
      "environment": "production"
    }
    

*   `web3SignerUrl` - paramétré sur `"http://signer:9000"`
    

### Créez le service docker-compose

    docker-compose create
    

### Exécutez docker-compose

    docker-compose up -d
    

Vérifiez qu’il fonctionne bien en appelant `/config`. Exécutez la commande suivante:

    curl localhost:8080/config
    

Cet exemple de commande considère que ROUTER\_EXTERNAL\_PORT est réglé sur 8080.

Le terminal devrait afficher quelque chose de similaire à:

    {"signerAddress":"0x627306090abaB3A6e1400e9345bC60c78a8BEf57"}
    

### Mettre à jour la version du routeur

1.  Modifiez `.env` avec la nouvelle `NXTP_VERSION`.
    
2.  Mettez la pile à jour.
    

    docker-compose pull
    docker-compose up -d
    

![](https://storage.googleapis.com/papyrus_images/138e22bb500cc8d3824bb7849315f73c8e02ba0fb2542e6533f2e2ae21049561.png)

Demander des tokens de test
---------------------------

Visitez l’IU test (interface utilisateur) développée par Coinhippo:

[https://amarok-testnet.coinhippo.io](https://amarok-testnet.coinhippo.io)

![](https://storage.googleapis.com/papyrus_images/c5454a3fda474ab775660579c253689d16475ba4a8267dedd8ac36b4422eab58.png)

Utilisez le faucet pour demander des tokens TEST sur la.les chain.s de votre choix.

### Ajoutez de la liquidité

Insérez l’adresse de votre routeur à la suite du lien ci-dessous:

    https://testnet.amarok.connextscan.io/router/<votre_adresse_de_routeur>
    

Cliquez sur “Manage Router” et ajouter de la liquidité en tokens TEST sur la.les chain.s de votre choix.

![](https://storage.googleapis.com/papyrus_images/1726a474cdd1cb8022da10d1fe5193f64869cd0473c14dd258f0ad6347b2e594.png)

### Testez le bridge testnet sur la même IU.

Félicitations ! Vous faîtes tourner votre propre routeur Connext !
------------------------------------------------------------------

---

*Originally published on [Oozman](https://paragraph.com/@oozman/routeur-connext-guide-d-installation)*