Skip to content

Latest commit

 

History

History
157 lines (108 loc) · 3.85 KB

README.md

File metadata and controls

157 lines (108 loc) · 3.85 KB
Raw

ilp-connector-docker

ILP connector With XRP

Docker images are built for quick deployment in various computing cloud providers. For more information on docker and containerization technologies, refer to official document.

Prepare the host

Many cloud providers offer docker-ready environments, for instance the CoreOS Droplet in DigitalOcean or the Container-Optimized OS in Google Cloud.

If you need to install docker yourself, follow the official installation guide.

Before starting you need to have a domain for the certificate .

If you are using ubuntu 14.4 you may have an issue running certbot, if so try to export the following variables and run it again:

export LC_ALL="en_US.UTF-8"
export LC_CTYPE="en_US.UTF-8"
  1. Clone the repo
$ git clone https://github.com/N3TC4T/ilp-connector-docker.git ~/ilp-connector
  1. Download the installer
$ wget https://dl.eff.org/certbot-auto
  1. Allow it to be an executable
$ chmod a+x certbot-auto
  1. Get SSL certificate for your domain
$ ./certbot-auto certonly --standalone -d <YOUR_DOMAIN>

  1. Type your email

  2. Decide if you want to share your email or not

  3. Copy then to your certs folder, see that you need to update the following path your your server path:

$ cp /etc/letsencrypt/live/<YOUR_DOMAIN>/* ~/ilp-connector/nginx/certs/
  1. Edit connector config and fill the required informations
$ vim ~/ilp-connector/app/launch.config.js

Use docker-compose to manage

It is very handy to use docker-compose to manage docker containers. You can download the binary at https://github.com/docker/compose/releases.

This is a sample docker-compose.yml file.

version: '2'
services:
  nginx:
      container_name: Nginx
      build: nginx
      network_mode: host
      ports:
        - '80:80'
        - '443:443'
      depends_on:
          - "app"
      environment:
        - DOMAIN_NAME=btp.my-domain.com
  gui:
        container_name: GUI
        build: gui
        network_mode: host
        ports:
          - "127.0.0.1:7770:7770"
        depends_on:
              - "app"
  app:
      container_name: APP
      build: app
      network_mode: host
      ports:
        - "127.0.0.1:7443:7443"
        - "127.0.0.1:7769:7769"
        - "127.0.0.1:7768:7768"

Run the connector

$ cd ~/ilp-connector
$ docker-compose up -d
$ docker-compose ps

Access your Connector

Use as your Moneyd

You can access your deployed connector by tunnelling its ilp-plugin-mini-accounts instance to your local machine. Then any application can access it via port 7768, just as though you were running moneyd.

You should have an IP address for your connector, once it's deployed. To get access to your funds locally, just run the following command:

ssh -N -L 7768:localhost:7768 root@YOUR_IP_ADDRESS

Replace YOUR_IP_ADDRESS with your IP address. This command should produce no output; just keep the command running to keep the port-forward running.

To test your ILP connection, try these examples from moneyd's README.

Monitor with Moneyd-GUI

The connector you deployed comes with a GUI to view routes, ping destinations, and send test payments. This GUI runs as a webserver.

To access it, forward the GUI's port to your local machine.

ssh -N -L 7770:localhost:7770 root@YOUR_IP_ADDRESS

Contact