This document outlines how to configure SDK daemon settings and what options are available. They can be found on the lbry GitHub repository in conf.py.

Daemon settings configuration

The easiest way to configure the settings is by editing the daemon_settings.yml file (may need to be created) that resides in the default lbrynet directory. These settings can also be configured via the settings_set API call. The settings_get API call can be used to retrieve current values. Some values will require an SDK restart after being set via the API call.

Sample daemon_settings.yml file:

tcp_port: 3335
lbryum_servers: ['lbryumx1.lbry.com:50001','lbryumx2.lbry.com:50001']
download_directory: 'c:\lbry\Downloads'
use_upnp: false

To run the SDK with a specific configuration file, launch it by passing the config path: lbrynet start --config=c:\path\to\conf\daemon_settings.yml. To run in debug mode, start with lbrynet start --verbose=lbrynet.

Configuration options

Configuration options are organized by their respective areas: Files, Wallet, Network, Security and Other.

Files

Setting Format Default value Sample Values Description
data_dir string 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_dir string local downloads folder ‘c:\lbry\lbrynet’ Location of downloaded output files

Wallet

Setting Format Default value Sample Values Description
blockchain_name string ‘lbrycrd_main’ ‘lbrycrd_regtest’ Blockchain network to connect to
lbryum_servers list [‘lbryumx1.lbry.com:50001’,‘lbryumx2.lbry.com:50001’] ["mylbryum.lbry.com:50001] SPV wallet server address
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
wallet string ‘lbryum’ ‘lbrycrd’ Choice of wallet software, SPV (lbryum) vs full node (lbrycrd). Currently only lbryum supported
use_keyring boolean false true Store wallet password in keyring (not currently available)

Network

Setting Format Default value Sample Values Description
api string localhost:5279 0:0:0:0:5280 IP address and port the SDK 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)
udp_port integer 4444 4445 UDP port used to announce blobs
download_timeout integer 30 60 Time, in seconds, to allow download to get data blobs
announce_head_blobs_only boolean true false Only announce first data blob
concurrent_blob_announcers integer 10 0 Threads used in order to announce blobs. 0 means disabled
known_dht_nodes list [‘lbrynet1.lbry.com:4444’] [‘myDHT.lbry.com: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
tcp_port integer 3333 3334 Port the SDK will listen on
concurrent-reflector-uploads integer 5 10 Connections to use while uploading data to reflector
reflect_streams boolean true false Send published data to reflector servers
reflector_servers list [‘reflector.lbry.com’] [‘myreflector.lbry.com’] Server data will be reflected to
fixed-peer-delay integer 2 5 Time, in mintues, to allow download from P2P before trying fixed peer
peer_connect_timeout integer 30 15 Time, in seconds, to allow download to find peers
node_rpc_timeout integer 5 10 Time, in seconds, to allow connection over DHT
network_interface string 0:0:0:0 127.0.0.1 Interface to use for the DHT and blob exchange
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
components_to_skip list [] [‘reflector’,‘hash_announcer’] Disable components, see entire list here
share_usage_data boolean true false Share analytics data