Add readme to configurator (#15)

* add an images to img directory

* Add configurator readme

* Apply suggestions from code review

Co-authored-by: Andrew Camilleri <evilkukka@gmail.com>

* add local deployment with Docker

* Update README.md

Co-authored-by: Andrew Camilleri <evilkukka@gmail.com>
This commit is contained in:
britttttk 2020-10-22 00:12:51 -06:00 committed by GitHub
parent 75d8b84919
commit f568ea9c9e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
13 changed files with 118 additions and 0 deletions

118
README.md Normal file
View File

@ -0,0 +1,118 @@
# Deploy BTCPay with Configurator
BTCPay Server can easily be configured and deployed to a server using Configurator. This tool makes makes deployment simple by allowing users to initialize or modify their BTCPay setup from the Configurator.
Configurator can be used to modify an existing BTCPay Server, from the admin account only. Other users may visit the server's Configurator url to deploy new BTCPay instances. When enabled, Configurator is located at
Someone such as a BTCPay third-party host may provide a Configurator instance for their users. This can help transition users to a self-hosted solution when they are ready to stop using the third-party host's server.
Another use-case is for server admins who are deploying BTCPay Server's on behalf of clients or other users as part of a consulting business. Admins can easily export a Docker deployment script from Configurator selections or deploy the configuration immediately to a VPS or on-premise server using SSH.
# How to set up Configurator
## Option 1: Add as an external service to BTCPay
If you already have an existing BTCPay Server [deployed](https://docs.btcpayserver.org/Deployment/) with the `opt-add-configurator` [environment variable added](https://docs.btcpayserver.org/FAQ/FAQ-Deployment#how-can-i-modify-or-deactivate-environment-variables), view your Configurator by navigating to:
**Server Settings > Services > Other external services > Configurator > Click See information**
Once enabled, non-admins may also view the Configurator at: `yourbtcpaydomain.com/configurator`.
## Option 2: Build locally with Docker
If you have Docker installed on your machine, you can open a terminal and the run the following command to run Configurator inside of a Docker container to use on your local machine:
`docker run -p 1337:80 --name btcpayserver-configurator btcpayserver/btcpayserver-configurator`
Now you can open a browser tab and view your Configurator at **localhost:1337**
# How to use Configurator
Step 1: Destination
Select an option to deploy using SSH now or generate a bash script for later deployment.
![Select Deployment](./docs/img/ConfiguratorStep1.png)
To configure and deploy a server now, provide your SSH credentials where you would like it deployed to.
![Provide SSH Details](./docs/img/ConfiguratorStep1ssh.png)
Note: The "Load Existing Settings" option will use the previous deployment's selections for faster configuration if you are modifying an existing installation.
Step 2: Domain
Provide the domain name associated with your server IP address.
![Provide Domain](./docs/img/ConfiguratorStep2.png)
Step 3: Chain
Select the desired Bitcoin network type, Bitcoin node pruning level and add any altcoins.
![Select Chain](./docs/img/ConfiguratorStep3.png)
Step 4: Lightning
Select the desired Lightning network option (optional).
![Lightning Options](./docs/img/ConfiguratorStep4.png)
Step 5: Additional
Add any additional services to your BTCPay Server deployment (optional).
![Docker Options](./docs/img/ConfiguratorStep5.png)
Step 6: Advanced
Provide any additional advanced settings (optional).
![Advanced Settings](./docs/img/ConfiguratorStep6.png)
Step 7: Summary
Verify your configuration settings look correct before deploying the server.
![Review Settings](./docs/img/ConfiguratorStep7.png)
During Deployment:
Configurator will SSH into the target server and do the following actions completely automated on your behalf:
- Install Docker
- Install Docker-Compose
- Install Git
- Setup BTCPay settings
- Make sure it starts at reboot via upstart or systemd
- Add BTCPay utilities in /user/bin
- Start BTCPay
The deployment progress will be displayed in your Configurator.
![Wait for Deployment](./docs/img/ConfiguratorDeploy1.png)
Upon deployment completion, Configurator will display the domain of the newly configured BTCPay Server.
![Deployment Location](./docs/img/ConfiguratorDeploy2.png)
The list of executed commands that were used to deploy the server configuration are also displayed.
![Executed Commands](./docs/img/ConfiguratorDeploy3.png)
## Export Manual Configuration
If you want to deploy the configuration to your server at a later time, you can instead export a bash script of your settings. Later you can paste the configuration into your server terminal.
![Manual Script](./docs/img/ConfiguratorDeployManual.png)
## Privacy & Security Concerns
If you are using someone else's Configurator to deploy your BTCPay Server, such as a [trusted Third-Party](https://docs.btcpayserver.org/ThirdParty/), you will be providing them with your:
- server IP/domain and ssh password
- server configuration settings
Users are advised to change their SSH password after Configurator deployment is complete.
To mitigate these privacy and security concerns, use either the [local deployment with Docker](#option-2-build-locally-with-Docker) or the [exported manual script](#export-manual-configuration) without providing your domain. Be sure to include the domain when you paste the commands into your terminal.

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB