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/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: ['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](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    | ['lbryumx1.lbry.com:50001','lbryumx2.lbry.com:50001']  | ["mylbryum.lbry.com:50001]          | SPV wallet server address                                                                         |
| 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                                     |
| 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                                             |

### 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](https://github.com/lbryio/lbry-sdk/blob/master/lbrynet/daemon/auth/server.py#L179)   for details   |

### 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 repo was renamed to lbry-sdk 2019-06-21 05:43:42 +02: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/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`
Initial commit 2019-03-19 23:56:32 +01:00			`lbryum_servers: ['lbryumx1.lbry.com:50001','lbryumx2.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 \|`
Initial commit 2019-03-19 23:56:32 +01:00			`\| 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](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 \|`
			`\|----------------------------\|---------\|---------------------------\|----------------------------\|------------------------------------------------------------------------------------\|`
daemon settings update for 0.31+ 2019-03-08 07:22:12 +01:00			`\| api \| string \| localhost:5279 \| 0:0:0:0:5280 \| IP address and port the SDK API 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 \|`
Create daemon-settings.md 2018-08-24 20:50:13 +02:00
			`### Security`

			`\| Setting \| Format \| Default value \| Sample Values \| Description \|`
			`\|----------------\|---------\|---------------\|--------------------\|----------------------------------------------------------------------------------------------------------------------------------\|`
			`\| allowed_origin \| string \| '' \| '*' or localhost \| IP address to allow API requests from \|`
lbry repo was renamed to lbry-sdk 2019-06-21 05:43:42 +02:00			`\| use_auth_http \| boolean \| false \| true \| See [authentication instructions](https://github.com/lbryio/lbry-sdk/blob/master/lbrynet/daemon/auth/server.py#L179) for details \|`
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 \|`