lbry.tech/documents/resources/daemon-settings.md

---
title: SDK Settings
description: The daemon provided by the LBRY SDK has many settings. This resource lists them all and what they mean. Ready, set, settings! 
---

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](https://github.com/lbryio/lbry-sdk/blob/master/lbry/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](https://lbry.com/faq/lbry-directories). These settings can also be configured via the [settings_set](https://lbry.tech/api/sdk#settings_set) API call. The [settings_get](https://lbry.tech/api/sdk#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: ['spv11.lbry.com:50001','spv19.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](https://lbry.com/faq/lbry-directories) | '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    | ['spv11.lbry.com:50001','spv19.lbry.com:50001']  | ["mylbryum.lbry.com:50001]          | SPV wallet server address(Default servers are spv11-spv19)                                                                         |
| wallet_dir                    | string  | [varies by OS](https://lbry.com/faq/lbry-directories) | '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     |
| streaming_server           | string  | localhost:5280            | 0:0:0:0:5280               | IP address and port the media/streaming server 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 get call to resolve and get initial blobs               |
| blob_download_timeout      | integer | 30                        | 60                         | Time, in seconds, to allow download to get next blob                               |
| 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_download | 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                                             |
| streaming_get              | boolean | false                     | true                       | Allow calling localhost:5280/get/claimname requests                                       |
| save_files                 | boolean | true                      | false                      | Save files with each download                                            |
| save_blobs                 | boolean | true                      | false                      | Save blobs with each download                                            |
### Other
| Setting            | Format  | Default value | Sample Values                  | Description                                                                                                   |
|--------------------|---------|---------------|--------------------------------|---------------------------------------------------------------------------------------------------------------|
| components_to_skip | list    | []            | ['reflector','hash_announcer'] | Disable components, [see entire list here](https://github.com/lbryio/lbry-sdk/wiki/Component-Dependencies-Table)  |
| share_usage_data   | boolean | true          | false                          | Share analytics data                                                                                          |
add metadata, fix metadata 2019-02-15 17:50:56 +01:00			`---`
			`title: SDK Settings`
			`description: The daemon provided by the LBRY SDK has many settings. This resource lists them all and what they mean. Ready, set, settings!`
Initial commit 2019-03-19 23:56:32 +01:00			`---`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
lbry directory in lbry-sdk repo moved up one level 2020-01-01 01:20:37 +01:00			`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](https://github.com/lbryio/lbry-sdk/blob/master/lbry/conf.py).`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
Initial commit 2019-03-19 23:56:32 +01:00			`## Daemon settings configuration`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
Initial commit 2019-03-19 23:56:32 +01:00			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](https://lbry.com/faq/lbry-directories). These settings can also be configured via the [settings_set](https://lbry.tech/api/sdk#settings_set) API call. The [settings_get](https://lbry.tech/api/sdk#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.
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
			`Sample daemon_settings.yml file:`
			```
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`tcp_port: 3335`
Update wallet address default values I noticed that default wallet server addresses were old and didn't worked. Updated values and added list of default servers into "Description", since listing them in "Default value" made page too wide on preview. 2020-05-17 11:37:12 +02:00			`lbryum_servers: ['spv11.lbry.com:50001','spv19.lbry.com:50001']`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00			`download_directory: 'c:\lbry\Downloads'`
			`use_upnp: false`
			```

daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			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```.

Create daemon-settings.md 2018-08-24 20:50:13 +02:00			`## Configuration options`
grammar/spelling/updates 2018-08-24 21:06:57 +02:00			`Configuration options are organized by their respective areas: Files, Wallet, Network, Security and Other.`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
			`### Files`
			`\| Setting \| Format \| Default value \| Sample Values \| Description \|`
			`\|------------------------\|---------\|------------------------------------------------------\|--------------------\|--------------------------------------------------------------------------------------\|`
Initial commit 2019-03-19 23:56:32 +01:00			`\| data_dir \| string \| [varies by OS](https://lbry.com/faq/lbry-directories) \| 'c:\lbry\lbrynet\' \| Where to store the lbrynet folder, which includes blob files, logs and config data \|`
minor updates true/false to lowercase Add notes about 0 settings. 2018-08-27 18:21:02 +02:00			`\| delete_blobs_on_remove \| boolean \| true \| false \| Delete blobs on a file_delete call? \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| download_dir \| string \| local downloads folder \| 'c:\lbry\lbrynet\' \| Location of downloaded output files \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
			`### Wallet`
			`\| Setting \| Format \| Default value \| Sample Values \| Description \|`
			`\|-------------------------------\|---------\|------------------------------------------------------\|------------------------------------\|---------------------------------------------------------------------------------------------------\|`
grammar/spelling/updates 2018-08-24 21:06:57 +02:00			`\| blockchain_name \| string \| 'lbrycrd_main' \| 'lbrycrd_regtest' \| Blockchain network to connect to \|`
Update wallet address default values I noticed that default wallet server addresses were old and didn't worked. Updated values and added list of default servers into "Description", since listing them in "Default value" made page too wide on preview. 2020-05-17 11:37:12 +02:00			`\| lbryum_servers \| list \| ['spv11.lbry.com:50001','spv19.lbry.com:50001'] \| ["mylbryum.lbry.com:50001] \| SPV wallet server address(Default servers are spv11-spv19) \|`
Initial commit 2019-03-19 23:56:32 +01:00			`\| wallet_dir \| string \| [varies by OS](https://lbry.com/faq/lbry-directories) \| 'c:\lbry\lbryum\' \| Wallet data location \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00			`\| 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 \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| use_keyring \| boolean \| false \| true \| Store wallet password in keyring (not currently available) \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
			`### Network`
			`\| Setting \| Format \| Default value \| Sample Values \| Description \|`
			`\|----------------------------\|---------\|---------------------------\|----------------------------\|------------------------------------------------------------------------------------\|`
Add streaming_server to table of daemon settings I guessed this option while trying to get LBRY to run when I connect to a VPN. Thought I'd add it to the page. 2019-08-26 03:04:14 +02:00			`\| api \| string \| localhost:5279 \| 0:0:0:0:5280 \| IP address and port the SDK API will listen on \|`
			`\| streaming_server \| string \| localhost:5280 \| 0:0:0:0:5280 \| IP address and port the media/streaming server will listen on \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00			`\| cache_time \| integer \| 150 \| 90 \| How long to keep resolve data in cache \|`
grammar/spelling/updates 2018-08-24 21:06:57 +02:00			`\| data_rate \| float \| 0.0001 \| 0.05 \| What LBC rate, per MB, to offer DHT data at (currently disabled in the protocol) \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| udp_port \| integer \| 4444 \| 4445 \| UDP port used to announce blobs \|`
Update daemon-settings.md 2019-05-20 20:34:40 +02:00			`\| download_timeout \| integer \| 30 \| 60 \| Time, in seconds, to allow get call to resolve and get initial blobs \|`
			`\| blob_download_timeout \| integer \| 30 \| 60 \| Time, in seconds, to allow download to get next blob \|`
minor updates true/false to lowercase Add notes about 0 settings. 2018-08-27 18:21:02 +02:00			`\| announce_head_blobs_only \| boolean \| true \| false \| Only announce first data blob \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| concurrent_blob_announcers \| integer \| 10 \| 0 \| Threads used in order to announce blobs. 0 means disabled \|`
Update daemon-settings.md 2019-05-20 20:34:40 +02:00			`\| known_dht_nodes \| list \| ['lbrynet1.lbry.com:4444'] \| ['myDHT.lbry.com:4444'] \| Bootstrap nodes for network connectivity \|`
			`\| max_connections_per_download \| integer \| 5 \| 10 \| Threads used to download blobs \|`
minor updates true/false to lowercase Add notes about 0 settings. 2018-08-27 18:21:02 +02:00			`\| seek_head_blob_first \| boolean \| true \| false \| Search for first data blob after downloading sd blob \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| tcp_port \| integer \| 3333 \| 3334 \| Port the SDK will listen on \|`
Update daemon-settings.md 2019-05-20 20:34:40 +02:00			`\| concurrent_reflector_uploads\| integer \| 5 \| 10 \| Connections to use while uploading data to reflector \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| reflect_streams \| boolean \| true \| false \| Send published data to reflector servers \|`
Update daemon-settings.md 2019-05-20 20:34:40 +02:00			`\| reflector_servers \| list \| ['reflector.lbry.com'] \| ['myreflector.lbry.com'] \| Server data will be reflected to \|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| 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 \|`
minor updates true/false to lowercase Add notes about 0 settings. 2018-08-27 18:21:02 +02:00			`\| use_upnp \| boolean \| true \| false \| Attempt external port mapping via UPnP \|`
add streaming options 2019-08-06 16:57:26 +02:00			`\| streaming_get \| boolean \| false \| true \| Allow calling localhost:5280/get/claimname requests \|`
			`\| save_files \| boolean \| true \| false \| Save files with each download \|`
			`\| save_blobs \| boolean \| true \| false \| Save blobs with each download \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00			`### Other`
			`\| Setting \| Format \| Default value \| Sample Values \| Description \|`
			`\|--------------------\|---------\|---------------\|--------------------------------\|---------------------------------------------------------------------------------------------------------------\|`
lbry repo was renamed to lbry-sdk 2019-06-21 05:43:42 +02:00			`\| components_to_skip \| list \| [] \| ['reflector','hash_announcer'] \| Disable components, [see entire list here](https://github.com/lbryio/lbry-sdk/wiki/Component-Dependencies-Table) \|`
minor updates true/false to lowercase Add notes about 0 settings. 2018-08-27 18:21:02 +02:00			`\| share_usage_data \| boolean \| true \| false \| Share analytics data \|`