10 KiB
10 KiB
Configurable settings for the LBRY daemon
This document outlines how to configure daemon settings and what options are available. They can be found on the lbry GitHub reposition in conf.py.
Daemon settings configuration
The easiest way to configure the settings is via the daemon_settings.yml in the default lbrynet directory. These settings will also be made available (currently only a few are) via the settings_set.
Sample daemon_settings.yml file:
peer_port: 3335
lbryum_servers: ['lbryumx1.lbry.io:50001','lbryumx2.lbry.io:50001']
download_directory: 'c:\lbry\Downloads'
use_upnp: false
Configuration options
Cofiguration options are separted by their respective areas: Files, Wallet, Network, Security and Other.
Files
| Setting | Format | Default value | Sample Values | Description |
|---|---|---|---|---|
| data_dir | str | varies by OS | 'c:\lbry\lbrynet' | Where to store the lbrynet folder, which includes blob files, logs and config data |
| delete_blobs_on_remove | boolean | TRUE | FALSE | Delete blobs on a file_delete call? |
| download_directory | string | local downloads folder | 'c:\lbry\lbrynet' | Location of downloaded output files |
Wallet
| Setting | Format | Default value | Sample Values | Description |
|---|---|---|---|---|
| auto_renew_claim_height_delta | integer | 0 | 1000 | If your claim is X blocks away, auto renew it. |
| lbryum_wallet_dir | string | varies by OS | 'c:\lbry\lbryum' | Wallet data location |
| max_key_fee | json | {'currency': 'USD', 'amount': 50.0} | {'currency': 'LBC', 'amount': 5.0} | Max payment allowed for content |
| disable_max_key_fee | boolean | FALSE | TRUE | If disabled, don't check for max fee |
| use_keyring | boolean | FALSE | TRUE | Store wallet password in keyring |
| wallet | string | 'lbryum' | 'lbrycrd' | Choice of wallet software, SPV (lbryum) vs full node (lbrycrd). Currently only lbryum supported |
| blockchain_name | string | 'lbrycrd_main' | 'lbrycrd_regtest' | Blockchain network to connect to |
| lbryum_servers | list | ['lbryumx1.lbry.io:50001','lbryumx2.lbry.io:50001'] | ["mylbryum.lbry.io:50001] | SPV wallet address |
Network
| Setting | Format | Default value | Sample Values | Description |
|---|---|---|---|---|
| api_host | string | localhost | 0.0.0.0 | IP address the daemon API will listen on |
| api_port | integer | 5279 | 9000 | Port the daemon API will listen on |
| cache_time | integer | 150 | 90 | How long to keep resolve data in cache |
| data_rate | float | 0.0001 | 0.05 | What LBC rate, per MB, to offer DHT data at (currently disabled in the protocol) |
| dht_node_port | integer | 4444 | 4445 | UDP port used to announce blobs |
| download_timeout | integer | 180 | 30 | Time, in seconds, to allow download to get data blobs |
| download_mirrors | list | ['blobs.lbry.io'] | 0 or [myreflector.lbry.io] | Location of mirrored content |
| is_generous_host | boolean | TRUE | FALSE | Host blobs without data payments |
| announce_head_blobs_only | boolean | TRUE | FALSE | Only announce first data blob |
| concurrent_announcers | integer | 10 | 0 | Threads used in order to announce blobs |
| known_dht_nodes | list | ['lbrynet1.lbry.io:4444'] | ['myDHT.lbry.io:4444'] | Bootstrap nodes for network connectivity |
| max_connections_per_stream | integer | 5 | 10 | Threads used to download blobs |
| seek_head_blob_first | boolean | TRUE | FALSE | Search for first data blob after downloading sd blob |
| peer_port | integer | 3333 | 3334 | Port the daemon will listen on |
| reflector_port | integer | 5566 | 5555 | Reflector port to listen on |
| reflect_uploads | boolean | TRUE | FALSE | Send published data to reflector servers |
| auto_re_reflect_interval | integer | 86400 (1 day) | 43200 | Time in seconds to re-check reflected data |
| reflector_servers | list | ['reflector.lbry.io'] | ['myreflector.lbry.io'] | Server data will be reflected to |
| run_reflector_server | boolean | FALSE | TRUE | Daemon will act as a reflector node - accept data from other nodes |
| sd_download_timeout | integer | 3 | 1 | Time, in mintues, to allow download to get sd blob |
| peer_search_timeout | integer | 60 | 30 | Time, in seconds, to allow download to find peers |
| use_upnp | boolean | TRUE | FALSE | Attempt external port mapping via UPnP |
Security
| Setting | Format | Default value | Sample Values | Description |
|---|---|---|---|---|
| allowed_origin | string | '' | '*' or localhost | IP address to allow API requests from |
| use_auth_http | boolean | FALSE | TRUE | See authentication instructions for details |
Other
| Setting | Format | Default value | Sample Values | Description |
|---|---|---|---|---|
| share_usage_data | boolean | TRUE | FALSE | Share analytics data |
| components_to_skip | list | [] | ['reflector','hash_announcer'] | Disabe components, see entire list here |