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 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. Currently not all settings are made available via the API calls, see GitHub issue 1374.

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

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_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. 0 means disabled (default)
blockchain_name string ‘lbrycrd_main’ ‘lbrycrd_regtest’ Blockchain network to connect to
disable_max_key_fee boolean false true If disabled, don’t check for max fee
lbryum_servers list [‘lbryumx1.lbry.io:50001’,‘lbryumx2.lbry.io:50001’] ["mylbryum.lbry.io:50001] SPV wallet server address
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
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

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. 0 means disabled.
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. 0 means disabled
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
components_to_skip list [] [‘reflector’,‘hash_announcer’] Disabe components, see entire list here
share_usage_data boolean true false Share analytics data

This website is in beta and under heavy development.
All information should be considered incomplete and possibly incorrect and things may not work as expected.



Please do not share or link this site publicly while this message is here. This website is open source and you can contribute to it on Github.