Browse Source

docs

dependabot/npm_and_yarn/ini-1.3.7
Evan Feenstra 4 years ago
parent
commit
bc251cc899
  1. 1
      README.md
  2. 3
      docs/docker_deployment.md
  3. 58
      docs/myNode_deployment.md
  4. 29
      docs/raspiblitz_deployment.md

1
README.md

@ -135,7 +135,6 @@ To connect your Desktop Sphinx to your Relay:
- restart the Relay machine; - restart the Relay machine;
- connect as `admin`; - connect as `admin`;
- switch to user `bitcoin` with `sudo su bitcoin`; - switch to user `bitcoin` with `sudo su bitcoin`;
- make sure `NODE_IP` environment variable contains correct `<IP>:<port>` values, `export` again if necessary;
- `cd ~/sphinx-relay; npm run prod` - `cd ~/sphinx-relay; npm run prod`
Then try again. Then try again.

3
docs/docker_deployment.md

@ -68,8 +68,7 @@ Edit the "production" section of config/config.json
- Update "storage" to point to where you want your DB file to live - Update "storage" to point to where you want your DB file to live
To connect to your app To connect to your app
- `export NODE_IP=x.x.x.x` (you can use a domain name instead if you have that set up) - edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
- For extra security, `export USE_PASSWORD=true`
### run ### run

58
docs/myNode_deployment.md

@ -19,7 +19,7 @@ python2 (if not present): `$ sudo apt install python2`
### Open port 53001 on myNode ### Open port 53001 on myNode
**note**: Port 3001 is now taken by one of myNode apps. In this document we use port 53001, but this port can be whatever number you want. Just add PORT to your environment like `export PORT=55005`. **note**: Port 3001 is now taken by one of myNode apps. In this document we use port 53001, but this port can be whatever number you want. Just edit the `node_http_port` setting in config/app.json
Open up a console window with SSH. And login as root Open up a console window with SSH. And login as root
```sh ```sh
@ -65,7 +65,9 @@ Change the following 4 lines:
"macaroon_location": "/home/bitcoin/.lnd/data/chain/bitcoin/mainnet/admin.macaroon", "macaroon_location": "/home/bitcoin/.lnd/data/chain/bitcoin/mainnet/admin.macaroon",
"tls_location": "/mnt/hdd/mynode/lnd/tls.cert", "tls_location": "/mnt/hdd/mynode/lnd/tls.cert",
"lnd_log_location": "/home/bitcoin/.lnd/logs/bitcoin/mainnet/lnd.log", "lnd_log_location": "/home/bitcoin/.lnd/logs/bitcoin/mainnet/lnd.log",
``` ```
Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
Save and exit: Save and exit:
`Ctrl + X` `Ctrl + X`
@ -91,12 +93,8 @@ Save and exit:
#### If you want to use your Sphinx client within the same local network #### If you want to use your Sphinx client within the same local network
```sh Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:3001
```
where `x.x.x.x` is the local IP address of the machine running your Sphinx-Relay on your local network.
**note:** Sphinx client uses HTTP to communicate with **sphinx-relay**. Since setting up SSL on a local network is problematic (you don't have any domain names to authenticate with certificates), you have to rely on your local network security. Below is an example of how Sphinx/sphinx-relay communications look like in **tcpdump**: **note:** Sphinx client uses HTTP to communicate with **sphinx-relay**. Since setting up SSL on a local network is problematic (you don't have any domain names to authenticate with certificates), you have to rely on your local network security. Below is an example of how Sphinx/sphinx-relay communications look like in **tcpdump**:
@ -110,19 +108,11 @@ where `x.x.x.x` is the local IP address of the machine running your Sphinx-Relay
**note:** it is recommended to use SSL encryption for any communications between **Sphinx** and **sphinx-relay** outside of a trusted network. [**Docker deployment guide**](docs/docker-deployment.md) sets up SSL encryption for you automatically, you only have to obtain your domain and certificates. If you still want to set up **sphinx-relay** manually, the instructions to set up the SSL are below. **note:** it is recommended to use SSL encryption for any communications between **Sphinx** and **sphinx-relay** outside of a trusted network. [**Docker deployment guide**](docs/docker-deployment.md) sets up SSL encryption for you automatically, you only have to obtain your domain and certificates. If you still want to set up **sphinx-relay** manually, the instructions to set up the SSL are below.
```sh Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:53001
```
where `x.x.x.x` is the permanent public IP address of your router.
Make sure that port 53001 forwarding is properly set up. Make sure that port 53001 forwarding is properly set up.
For extra security:
```sh
$ export USE_PASSWORD=true
```
As noted in the previous section, you might want to protect communications between your Sphinx client and **sphinx-relay** with SSL. As noted in the previous section, you might want to protect communications between your Sphinx client and **sphinx-relay** with SSL.
In order to do that, obtain a domain and an SSL certificate for your **sphinx-relay** server and set up a reverse proxy with NGINX (or a more lightweight alternative). In order to do that, obtain a domain and an SSL certificate for your **sphinx-relay** server and set up a reverse proxy with NGINX (or a more lightweight alternative).
@ -259,23 +249,7 @@ Save and exit:
`Enter` `Enter`
Now we have to set the environment variables `PORT` and `NODE_IP` for the new `sphinx-relay.service`: Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name.
`sudo systemctl edit sphinx-relay`
This opens `nano` editor with an empty configuration file that you should type the following text into:
```
[Service]
Environment="PORT=53001"
Environment="NODE_IP=x.x.x.x:53001"
```
Save and exit:
`Ctrl + X`
`Y`
`Enter`
Let's run! Let's run!
```sh ```sh
@ -370,21 +344,11 @@ Save and exit:
#### If you want to use your Sphinx client within the same local network #### If you want to use your Sphinx client within the same local network
```sh Edit the `public_url` in config/app.json to equal the local IP address of your node
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:53001
```
where `x.x.x.x` is the local IP address of the machine running your Sphinx-Relay on your local network.
#### If you want to connect to your Sphinx-Relay from outside of your local network #### If you want to connect to your Sphinx-Relay from outside of your local network
```sh Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:53001
```
where `x.x.x.x` is the permanent public IP address of your router.
> Make sure that port 53001 forwarding is properly set up. > Make sure that port 53001 forwarding is properly set up.

29
docs/raspiblitz_deployment.md

@ -19,7 +19,7 @@ python2 (if not present): `$ sudo apt install python2`
### Open port 3001 on Raspiblitz ### Open port 3001 on Raspiblitz
**note**: This port can be whatever number you want. Just add PORT to your environment like `export PORT=5005`. **note**: This port can be whatever number you want. You can edit it in config/app.json in the `node_http_port` setting
Open up a console window with SSH. And log in as root Open up a console window with SSH. And log in as root
```sh ```sh
@ -90,12 +90,7 @@ Save and exit:
#### If you want to use your Sphinx client within the same local network #### If you want to use your Sphinx client within the same local network
```sh Edit the `public_url` in config/app.json to equal your local IP
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:3001
```
where `x.x.x.x` is the local IP address of the machine running your Sphinx-Relay on your local network.
**note:** Sphinx client uses HTTP to communicate with **sphinx-relay**. Since setting up SSL on a local network is problematic (you don't have any domain names to authenticate with certificates), you have to rely on your local network security. Below is an example of how Sphinx/sphinx-relay communications look like in **tcpdump**: **note:** Sphinx client uses HTTP to communicate with **sphinx-relay**. Since setting up SSL on a local network is problematic (you don't have any domain names to authenticate with certificates), you have to rely on your local network security. Below is an example of how Sphinx/sphinx-relay communications look like in **tcpdump**:
@ -109,12 +104,7 @@ where `x.x.x.x` is the local IP address of the machine running your Sphinx-Relay
**note:** it is recommended to use SSL encryption for any communications between **Sphinx** and **sphinx-relay** outside of a trusted network. [**Docker deployment guide**](docs/docker-deployment.md) sets up SSL encryption for you automatically, you only have to obtain your domain and certificates. If you still want to set up **sphinx-relay** manually, the instructions to set up the SSL are below. **note:** it is recommended to use SSL encryption for any communications between **Sphinx** and **sphinx-relay** outside of a trusted network. [**Docker deployment guide**](docs/docker-deployment.md) sets up SSL encryption for you automatically, you only have to obtain your domain and certificates. If you still want to set up **sphinx-relay** manually, the instructions to set up the SSL are below.
```sh Edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:3001
```
where `x.x.x.x` is the permanent public IP address of your router.
Make sure that port 3001 forwarding is properly set up. Make sure that port 3001 forwarding is properly set up.
@ -325,6 +315,8 @@ Change the following 4 lines:
"lncli_location": "/home/bitcoin/go/bin", "lncli_location": "/home/bitcoin/go/bin",
``` ```
Also edit the `public_url` in config/app.json to equal your public IP or fully qualified domain name
Save and exit: Save and exit:
`Ctrl + X` `Ctrl + X`
@ -347,17 +339,6 @@ Save and exit:
`Enter` `Enter`
To connect to your app:
(replace x.x.x.x with your IP - NOTE: This is your external IP)
```sh
$ cd
$ cd sphinx-relay/config/
$ export NODE_IP=x.x.x.x:3001
```
For extra security:
```sh
$ export USE_PASSWORD=true
```
### Turn on the service. ### Turn on the service.
Login as admin. Login as admin.
```sh ```sh

Loading…
Cancel
Save