gate - Setup instructions

gate needs to reach towers in order to request new transactions.

Since it will typically not be known beforehand where they will be connecting to, gate should have access to the Internet, ideally on clearnet and anonymity networks.

Requirements

By default, gate manages it's own wallet where money is charged to. It does not need to be reachable on the Internet.

A good place to run gate is on a firewalled device on a protected network.

Preparation

As root:

  1. Make sure both git and openssh are installed on your system

  2. [skip unless on Alpine Linux] Also add util-linux-login to get a compatible su-command 

     # Since we're at it, let's satisfy all dependencies at once:
 apk add bat coreutils-fmt curl git jq monero netcat-openbsd \
         openssh procps-ng util-linux-login util-linux-misc

  3. Create a dedicated user "gate" 

     # Depending on your Linux flavor, one of these commands may work:
 useradd -c 'noshore coordinator' -m gate
 # or
 adduser -Dg 'noshore coordinator' gate

Installation

As the newly created user (switch with su -Pl gate):

  1. Get gate by cloning NoShore: 

     git clone --branch v0.1.1 \
     https://gitlab.com/fullmetalScience/noshore.git ~/xmr.zone/noshore

  2. Run and re-run setup until you have taken care of all suggested configuration: 

     ~/xmr.zone/noshore/gate/manage.sh setup

Setup creates a shorthand command gate. If ~/.local/bin is in your $PATH, you may use that instead of the long form ~/xmr.zone/noshore/gate/manage.sh.

You may want to configure sentry next.