backup and account sync changes

This commit is contained in:
Thomas Zarebczan 2020-02-21 12:20:03 -05:00
parent 107e92166e
commit af73d995ac
No known key found for this signature in database
GPG key ID: D505010BDB4364BC
2 changed files with 29 additions and 12 deletions

View file

@ -3,33 +3,45 @@ title: lbry.tv account and wallet syncing
category: getstarted
order: 3
---
Users expect consistent experiences across devices and sessions. This includes everything from account preferences to subscriptions to account balances. In the land of central servers, this is straightforward, but in blockchain land, it is tricky. This article explains how we provide this functionality, various options in using it, and it's limitations.
## How it works
1. Every user, whether on LBRY Desktop, Android, or [lbry.tv](https://lbry.tv), has a single wallet file. This file stores your private keys (like a password) that controls your channels and account balances. The keys in this file are the only way to move or spend LBC or publish to your channel.
1. On an ongoing basis, your account preferences and other settings are written to your wallet file.
1. If you create a lbry.tv login and turn on account sync (backup), your wallet file will be copied to and from a LBRY, Inc. server each time you login and at regular intervals.
1. If you create a lbry.tv login and turn on account sync (backup), your wallet file will be backed up to and from a LBRY, Inc. server each time you login and at regular intervals.
1. Each time this happens, your preferences, channels, subscriptions, and other data will be updated on the new device.
1. If your wallet file has a password on it, LBRY, Inc. cannot see into your wallet or do anything with it, including reset your password.
## Using wallet sync
### I want to remove my synced data from lbry.tv
This process is currently manual, please [contact us](/faq/support).
### Sync limitations
As of writing, current limitations are:
- Can't set or change passwords (coming soon). Only Android allows setting of a password on new accounts currently.
- Cannot remove a previously synced account (i.e. which you don't know the password to). This process is currently manual, please [contact us](/faq/support)
- On Desktop, if you sign out and back in with a different email, these wallets and accounts will be merged. Do not do this unless it's intentional and you expect the new email to be used by the same person. To prevent this, rename/remove the [default_wallet file in the lbryum folder](/faq/lbry-directories) and quit the app with Ctrl-Q after signing out.
- Can't set or change passwords (coming in mid 2020) if you previously did not have one. If you'd like to do this manually, please [contact us](/faq/support).
- On Desktop, if you sign out and back in with a different email, these wallets and accounts will be merged. Do not do this unless it's intentional and you expect the new email to be used by the same person. To prevent this, rename/remove the [default_wallet file in the lbryum/wallets folder](/faq/lbry-directories) and quit the app with Ctrl-Q after signing out.
### Desktop
1. If running the desktop app for the first time, you will be prompted during the first-run process to opt-in.
1. If you want to opt-in later, click the Settings button in the top right and enable Sync.
1. If you previously had sync configured with a password (i.e on Android), you'll be prompted for this. If you do not remember, please [reach out to us](mailto:hello@lbry.com) so we can remove the existing synced account.
### Android
1. If running the Android app for the first time, you will be prompted during the first-run process to opt-in.
1. If you want to opt-in later, click your balance or navigate to the Wallet area and you will see the option to turn this on.
### lbry.tv
Syncing is automatically on for lbry.tv users and cannot be disabled. After all, what good would lbry.tv be if you could no longer use it once you signed out! If you have balances on other devices, these will not be reflected at this time.
Syncing is automatically on for lbry.tv users and cannot be disabled. After all, what good would lbry.tv be if you could no longer use it once you signed out! If you have balances on other devices, these will not be reflected at this time.
## I'm having trouble
If you have any trouble using or enrolling in account sync, check out this [FAQ article](/faq/how-to-report-bugs) on how to report this to us.

View file

@ -5,21 +5,24 @@ category: wallet
LBRY relies on blockchain technology and the LBRY Credits (LBC) cryptocurrency in order to participate in the network. These LBC are stored in a wallet (data file on your PC/device if using Desktop/Mobile) which is generated with each LBRY installation...think of your credits as digital cash on your PC. A wallet contains your funds, channel data, claims (any uploads), and preferences (subscriptions/tags/etc).
## Two ways to backup your wallet
### lbry.tv sync
An Account Sync service is provided automatically on [lbry.tv](https://lbry.tv) and can be enabled on Desktop/Mobile which allows LBRY to store a backup of the wallet for you. [Learn more](/faq/account-sync).
### User maintained backup
Otherwise, it is important to understand that the wallet is not stored on any LBRY servers (except when [sync](#sync) is enabled) and as such, users are responsible for its safeguarding and making sure [a backup](/faq/how-to-backup-wallet) (copy of the wallet file) is available in the event that it is lost. If a wallet is lost or needs to be transferred, follow the [restore procedures below](#restore).
*Note: If you are not using the sync service, wallets should be re-backed up after creating new Channels/Identities (this is stored directly in the wallet file, and not part of the seed/restore process at the moment).*
## Account Sync {#sync}
LBRY provides a wallet backup service by securely backing up your account and preferences. [Learn more here](/faq/account-sync).
_Note: If you are not using the sync service, wallets should be re-backed up after creating new Channels/Identities (this is stored directly in the wallet file, and not part of the seed/restore process at the moment)._
## How do I find my wallet in LBRY Desktop?
The easiest way to find the location of your LBRY wallet is via the [LBRY app](/get). Open LBRY and on the left side, you should see a sidebar menu called "Help" - the wallet location is in the **Backup Your LBRY Credits** section.
The easiest way to find the location of your LBRY wallet is via the [LBRY app](/get). Open LBRY and on the left side, you should see a sidebar menu called "Help" - the wallet location is in the **Backup Your LBRY Credits** section.
## How do I backup my LBRY Desktop wallet?
Click on "Help" and scroll down to the **Backup Your LBRY Credits** section.
When you click **Create Backup**, the app will generate a zip file of your wallet directory. You'll be directed to the folder it's saved to.
@ -40,8 +43,10 @@ The easiest way to find the location of your LBRY Android wallet is via the [And
![Find wallet](https://spee.ch/b3535b68750ad69c48566cb028c67d323d1fdeb9/walli.jpg)
## How do I backup my LBRY Android app wallet? {#android}
The Android wallet will be removed if you uninstall the app or clear data or do not participate in the [sync](#sync) program. Scroll to the top of this page to learn more about your wallet.
*Please note that this may vary with each Android device*
_Please note that this may vary with each Android device_
1. Open your favorite file manager, navigate to `Internal storage/android/data/io.lbry.browser/files/lbryum/wallets`
2. Copy the default_wallet to any other location on your device, i.e. your SD card or another directory on the Internal Storage