mynodebtc/mynode_docs

mynode_docs's Issues

BTCPay server

Is your content request related to a problem? Please describe.
This is an app to receive Bitcoin/lightning payments, targeted to merchants and self-employed folks. Security must be taken care of while writing the instructions.

Describe the solution you'd like

• Overview
• Setup
• Testing and sample usage
• Troubleshooting

Additional context
MyNode is one of the few providers of BTCPayServer bundled with Bitcoin/Lightning node. Once implemented successfully, it could empower a huge number of merchants around the world.

Multisig section

Is your content request related to a problem? Please describe.
This should include apps meant for creating multisig wallets.

Describe the solution you'd like

• Overview of multisig wallets, pros and cons
• Caravan
• Specter
• Trade-offs for using these apps, instead of other available options like Electrum, Casa

Static IP to handle device reboots

Is your content request related to a problem? Please describe.
While I enjoy setting up mynode to connect/interact with my devices (different wallets) – simple and easy experience – I don't really want to do it over and over again.

Every so often the mynode has to reboot. For an update, for a change in setting. Or maybe I have to do some fan cleaning. When this happens... I have noticed that the IP address used doesn't stay constant. The impact is that

i) All my LND links across my wallets stop working and have to be reset up.
ii) VPN settings need to be updated
iii) Onion links maybe stop working as well

Why is the IP changing? Not sure as not a network software dev (and it doesn't say assigned on the router).

Describe the solution you'd like
A few options could be possible ranking from h

1. Have the mynode self-assign/request an IP to the router so I don't have to think about
2. Setup a staticIP form the router using DHCP (basic instructions -> pointing with links for where/how to do it primarily. outlining the issue and ways around it so that folks don't have to think and dig, it is just there).
3. Something else that requires little rework.

Additional context
Add any other context or screenshots about the feature request here.

Integrate docs in MyNode to enable user to read it locally

Is your content request related to a problem? Please describe.
Instead of just hosting the documentation on a public website, the documentation should be include in the MyNode package to enable users in learning and troubleshooting the installed apps.

Describe the solution you'd like

• Host the complete website on a /docs route
• Link relevant articles inside every app
• Link relevant articles beside the known error messages (maybe for later)

Additional context
Hosting it locally on every mynode device will also help reduce the load on the public website and avoid the single point of failure.

This idea was originally suggested by "M D" on our private Telegram group.

LND unable to unlock macaroons

Describe the bug
After installing new myNode lightning services did not start after creating a wallet.

Expected behavior
To it to work as is in guideline

logs
On ldn logs I found following:
"2021-10-24 03:20:40.016 [ERR] LTND: unable to unlock macaroons: invalid password" on logs. I read abot that macaroon files could be deleted and those should be recreated on start of lnd again. But I cannot find those. Any advice how I could get this fixed?

Desktop (please complete the following information):
installed from myNode image to RaspberryPi 4 wiht 8Gb ram.

Additional context
I where able to fix issue by finding .macaroon and macaroons.db file and deleting those

step by step
go to terminal of myNode with ssh
Execute commands:

sudo find / -name "*.macaroon"
sudo find / -name "macaroons.db"

Then copy all find file paths and execute command one by one as following:

sudo rm *copy paths here*

Then go to myNode web and restart LND from myNode apps menu (http://mynode.local/apps)

Problem "Using Data from Existing Node" as documented

Describe the bug

I'm having a problem "Using Data from Existing Node" and I'd like to update the docs with the solution, once I find one.

My Steps
I issue this command

$ sudo scp -r [email protected]:/mnt/hdd/mynode/bitcoin/blocks /Volumes/myfolder/
[email protected]'s password:  xxxx

And the following is returned. Take Note: my issue is with Permission denied, not the other thing.

bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
scp: /mnt/hdd/mynode/bitcoin/blocks: Permission denied

Expected behavior

I would expect that using scp — as documented — to copy data should just work.

Things I've tried

• I tried adding user admin to the group named bitcoin before trying again. No effect.
• I tried sudo systemctl stop bitcoind and sudo systemctl stop lnd on the source myNode before trying again. No effect.

Question

Any insight to share on why I would receive Permission denied here? I'll amend the docs once we know why.

Ability to use Electrum with lightning wallet

Currently you can use the electrum server with the electrum light wallet. Awesome.
However, I don't know how you can then use the electrum light wallet for your lightning wallet on your node - through LND, without requiring you to input your seed words. If this is possible, are there any docs for how to do so?

Thanks!

Troubleshooting

Is your content request related to a problem? Please describe.
Guide for solving issues in any app on mynode.

Describe the solution you'd like
Issues could be originating from bugs, hardware problems or human errors. Report the mynode related bugs on the main repo with a proposed solution. If it's a third party bug, report it on their github repo. The UX should be improved to minimise human errors. Propose solutions while writing this guide for that too. Articles might be repeated in other sections where it's relevant.

Additional context

Electrum section

Is your content request related to a problem? Please describe.
All articles related to Electrum server should be included here

Describe the solution you'd like

• Overview
• Setup
• Connecting to Electrum wallet and other apps
• Troubleshooting

Additional context
Electrum server is a core part of mynode and dependent on Bitcoind, but including it in Bitcoin section might cramp that section.

"Getting started" section

Is your content request related to a problem? Please describe.
How to setup mynode? What to expect?

Describe the solution you'd like

• Hardware options and recommendations
• Flashing the card
• Using existing blockchain
• Converting Casa, RaspiBlitz, etc
• Wait time for IBD vs Quicksync
• Troubleshooting

Additional context
Instructions from the main website can be the baseline. Add screenshots for each step assuming the user has no prior experience with Linux. List all the available videos and articles on the internet.

Bitcoin section

Is your content request related to a problem? Please describe.
All pages related to Bitcoin app should be included in the Bitcoin section, except Electrum and Lightning.

Describe the solution you'd like

• Overview of Bitcoind
• Managing Bitcoind
• Quicksync
• Block explorer
• Mempool viewer
• Troubleshooting (should be repeated in troubleshooting section)

Additional context

Mynode cloning tool tries to make copy on Not_Found target drive. After update Version 0.2.25

Describe the bug
After update to 0.2.25 and during reboot system get stuck. Screen stops in cloning tool with warning data target drive will be lost. No second drive is connected to server. It detects 2Tb source drive whick it wants to copy to second drive /dev/NOT_FOUND. Reboots will give same screen.

Expected behavior
Reboot to normal startpage of server (from source drive). No activation clone tool because no second drive is attached.

Screenshots
Screenshot add.

Desktop (please complete the following information):

• OS: linux 5.10.11.v71+ #1399 armv71
• Browser nightly, chrome, edge
• Version

Smartphone (please complete the following information):

• Device: iphone7
• OS:
• Browser Safari
• Version

Additional context
Deleting script usr/bin/clone_drive.py gives error and still stuck in clone screen.
Used hardware p4-8gb and X829-C1 with 1x 2Tb hd

Tor section

Is your content request related to a problem? Please describe.
Describe the integration of Tor in Mynode and its applications. Some of them might be limited to premium users.

Describe the solution you'd like

• Overview
• Description of Tor page
• Connecting through Tor browser
• Fully noded
• Troubleshooting

Additional context
Add any other context or screenshots about the feature request here.

I'm trying to clone to an internal nvme harddrive after moving rpi drive to NUC (which all went smoothly). Has been stuck on "creating partition" for 40mins..

Describe the bug
stopped on "creating partition" for 40min.

Expected behavior
move to copying data

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: Debian NUC
• Browser chromian
• latest download

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Tor setup on Linux section has incomplete sentence

Description
Under the Tor setup on Linux section of docs there is an incomplete sentence: "You may also want to install"

Expected behavior
Sentence finishes describing what else user may want installed.

Screenshots

Desktop:

• OS: Mac OS X Ventura 13.2.1 (22D68)
• Safari 16.3

Deployment plans

• During development, this repo will be periodically (every weekend) copied to my private repo and hosted on Netlify: https://gracious-turing-7c789f.netlify.app/
• Once we reach the first milestone, we should host it on either docs.mynodebtc.com or mynodebtc.com, besides hosting it locally (#1)

Settings page - Networking section has old UI view

Is your content request related to a problem? Please describe.
Screenshot from UI is old at (https://github.com/mynodebtc/mynode_docs/tree/master/docs/networking)/tor.md

Describe the solution you'd like
Please update with latest version view.

Additional context
Please find updated view as attached:

General structure

For every app installed on mynode, few common things must be mentioned:

1. Introduction: there should be few paragraphs on what it is and how is it useful. This will educate users who are not exposed to some apps for the first time or still a newcomer.
2. Citation: Who developed it? Names, Github, website, official documentation, Telegram groups, etc
3. Memory and CPU usage
4. Limitations due to hardware or default configuration, and how much can they be changed

(Maybe, 3 and 4 should be aggregated in the advanced section)

Coinjoin section

Is your content request related to a problem? Please describe.
Coinjoin improves privacy while using an otherwise open ledger like Bitcoin. There are several implementations but myNode includes two of them: Joinmarket and Samourai. Hopefully, others will be added in the future

Describe the solution you'd like

• Overview: what is coinjoin?
• Samourai
  • Dojo
  • Whirlpool
• Joinmarket
• Troubleshooting

Additional context
Do not dive too deep into each app and try to link articles from respective sources to reduce the load.

Advanced section

Is your content request related to a problem? Please describe.
Advanced/power users with prior knowledge of Linux, Bitcoin and other apps might need some introduction to the general structure of MyNode implementation. We can safely assume that they can use SSH and can take risks.

Describe the solution you'd like

• Install locations
• Using mynode scripts
• Installing beta version or latest commits
• Setting up device from scratch
• Monitoring using Netdata, Glances, etc

Additional context
Add any other context or screenshots about the feature request here.

Stops syncing

Installed mynode via Virtual Machine OVA community edition 0.2.16 and constantly chain stop syncing, after restarting node starts sync but after a while stops again. Did not change anything just installed on Oracle VM Virtual Box. There is no error.

Lightning section

Is your content request related to a problem? Please describe.
All articles related to LND should be part of the Lightning section

Describe the solution you'd like

• Overview
• Setup
• LND Connect
• LND Hub
• RTL
• Thunderhub
• LNbits
• Connecting external mobile/desktop apps
• Troubleshooting

Additional context
It should be one stop shop for all things lightning related.

No Sphinx Relay documentaiton

Is your content request related to a problem? Please describe.
I bought the myNode software license because I wanted to run my own video streaming content. However that install does not seem to work for the relay.

Describe the solution you'd like
Would love to see docs that show someone else's sever getting sphinx chat running on their myNode.

Firewall & Reboot Text or Behavior on Settings page

Describe the bug
The device doesn't reboot after resetting the firewall by clicking the button.
The text says that it should. By this deduce that:
The text is wrong OR the behaviour is wrong OR something else
<img width="687" alt="Screen Shot 2020-12-24 at 06 44 09" src="https://user-images.githubusercontent.com/2773554/103086962-0c6f9080-45b4-11eb-80b8-9cfbde90d9f9.png">

Desktop (please complete the following information):

• OS: Mac, Big Sur 11.1
• Browser Chrome
• Version [Version 87.0.4280.88 (Official Build) (x86_64)

Smartphone (please complete the following information):
n/a

Additional context
Just a minor thing as I do thing. Figure this is easier than a text fork.
Let me know and happy to contribute as I explore,.

VPN section

Is your content request related to a problem? Please describe.
This is a premium feature to access MyNode remotely. Port over relevant articles from the main website.

Describe the solution you'd like

• Overview
• Setup and remote connection
• Troubleshooting