> For the complete documentation index, see [llms.txt](https://knowlg.sunbird.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowlg.sunbird.org/use/additional-reading/content-service-environment-variables.md).
# Content Service Environment Variables
### Overview
The page contains the list of environment variables, their descriptions, purpose and sample values, as required to run the Sunbird content service. To change default behavior, modify the variable value to suit your need or purpose.
### Variable List
| S NO. | VARIABLE NAME | DESCRIPTION | PURPOSE | SAMPLE VALUE |
| ----- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| 1 | ekstep\_telemetry\_storage\_toggle | Represents the toggle to turn the EkStep telemetry storage on or off | To turn the telemetry on or off | on |
| 2 | sunbird\_extcont\_whitelisted\_domains | Represents the file that stores the whitelisted domains in a comma-separated format | To store the white listed domains | youtube.com.youtu.be |
| 3 | sunbird\_default\_channel | Represents the default channel to generate telemetry, if nothing is sent from client headers. This is the same as specified in the learner service. It should be a valid root org | To ensure there is a channel for each telemetry event generated | |
| 4 | sunbird\_content\_plugin\_base\_url | Represents the proxy URL to the content plugins repository
This is needed only in the dev setup. In the server environment, plugins are handled by the nginx proxy
| To update the plugins base URL | |
| 5 | sunbird\_content\_provider\_api\_base\_url | Represents the base URL of the content provider | To update the content provider URL | |
| 6 | sunbird\_content\_provider\_api\_key | Represents the API Key to authorize the content provider | To authorize the content provider | |
| 7 | sunbird\_environment | Represents the instance environment | To identify the environment to which to send telemetry data with proper pdata. It is also used for other related purposes | |
| 8 | sunbird\_instance | Represents the name of the instance. This should be the same as the value in the player/learner-service | To set the name of the instance | |
| 9 | sunbird\_cassandra\_urls | Represents the URLs of Cassandra instance | To connect to Cassandra db | 127.0.0.1:9042 |
| 10 | sunbird\_cassandra\_consistency\_level | Represents the minimum number of Cassandra nodes that must acknowledge a read or write operation before the operation can be considered successful | To mantain the data consistency of multi node Cassandra | one |
| 11 | sunbird\_cassandra\_replication\_strategy | Represents data replication of cassandra | To replicate the Cassandra data set | ’{“class”:”SimpleStrategy”,”replication\_factor”:1}’ |
| 12 | sunbird\_keycloak\_auth\_server\_url | The URL of the Keycloak auth service to connect the Sunbird Content service | To connect the Keycloak server | |
| 13 | sunbird\_keycloak\_realm | Represents the keycloak realm value | To update the realm value of Keycloak, per installation | Sunbird |
| 14 | sunbird\_keycloak\_client\_id | Represents the client ID in Keycloak | To update the client ID in Keycloak | portal |
| 15 | sunbird\_keycloak\_public | Represents the Keycloak type | To specify the keycloak public type | true |
| 16 | sunbird\_image\_storage\_url | Represents the base URL where images are stored after generating the qrcode images | To edit the storage URL | |
| 17 | sunbird\_dial\_code\_registry\_url | Represents the base URL of the qr code image generated | To set the base URL for qr code | |
| 18 | sunbird\_azure\_account\_name | Represents the Azure account name to connect to Azure storage | To connect the Azure account | |
| 19 | sunbird\_azure\_account\_key | Represents the azure account key to connect to the Azure storage | To connect to Azure | |
| 20 | sunbird\_telemetry\_sync\_batch\_size | Represents the batch size to sync data | To set the size of events to be synced | 20 |
| 21 | sunbird\_content\_service\_whitelisted\_channels | Represents list of whitelisted channels (comma separated) | To whitelist channels | $.instance.all |
| 22 | sunbird\_content\_service\_blacklisted\_channels | Represents list of blacklisted channels (comma seperated) | To blacklist channels | 1.23E+19 |
| 23 | sunbird\_content\_service\_channel\_refresh\_cron | Represents the node cron interval string | To run cron every 5 minutes. enabled only if $.instance.all is present in whitelisted channels) | */5*\*\*\* |
| 24 | sunbird\_content\_service\_whitelisted\_framework | Represents list of whitelisted frameworks (comma seperated) | To whitelist frameworks while searching for content | NCF, NCFCOPY |
| 25 | sunbird\_content\_service\_blacklisted\_contenttype | Represents list of blacklisted content types(comma sepertaed) | To blacklist contenttype while searching for content | Asset |
| 26 | sunbird\_content\_service\_blacklisted\_resourcetype | Represents list of blacklisted resource types(comma seperated) | To blacklist contenttype while searching for content | Lesson plan |
| 27 | sunbird\_content\_service\_blacklisted\_mimetype | Represents list of blacklisted mime types(comma seperated) | To blacklist mimetype while searching for content | video/x-youtube |
| 28 | sunbird\_content\_service\_enable\_logging | To enable or disable the content service logging | | True |
| 29 | sunbird\_content\_repo\_api\_base\_url | Represents the proxy URL to the content repository | | |
| 30 | sunbird\_content\_repo\_api\_key | Represents the proxy URL API key for the content repository | | |
| 31 | sunbird\_search\_service\_api\_base\_url | Represents the proxy URL to the search service | | |
| 32 | sunbird\_search\_service\_api\_key | Represents the proxy URL API key for the search service | | True |
| 33 | sunbird\_dial\_repo\_api\_base\_url | Represents the proxy URL to the dial repository | | |
| 34 | sunbird\_dial\_repo\_api\_key | Represents the proxy URL API key for the dial repository | | |
| 35 | sunbird\_plugin\_repo\_api\_base\_url | Represents the proxy URL to the plugin repository for searching plugins | | |
| 36 | sunbird\_plugin\_repo\_api\_key | Represents the proxy URL API key to the plugin repository for searching plugins | | |
| 37 | sunbird\_data\_service\_api\_base\_url | Represents the proxy URL to the data service | | |
| 38 | sunbird\_data\_service\_api\_key | Represents the proxy URL API key for the data service | | |
| 39 | sunbird\_language\_service\_api\_base\_url | Represents the proxy URL to the language service | | |
| 40 | sunbird\_language\_service\_api\_key | Represents the proxy URL API key for the language service | | |
| 41 | sunbird\_portal\_base\_url | To construct the content link which will be sent in the email and also to read the Form API | | |
| 42 | sunbird\_gzip\_enable | Specifies the API response is enabled or disabled for zipping | | |
| 43 | sunbird\_cassandra\_consistency\_level | Provides consistency level in cassandra | | |
| 44 | sunbird\_cassandra\_replication\_strategy | Specifies the cassandra replication strategy | | |
| 45 | sunbird\_health\_check\_enable | Specifies that the health check of the dependant services to be checked or not (ex: true/false) | | |
| 46 | sunbird\_content\_service\_log\_level | Specifies the log level of this service (ex: info, debug, error, warn) | | |
**Related Pages**
* [Import External Content](/use/additional-reading/import-external-content.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://knowlg.sunbird.org/use/additional-reading/content-service-environment-variables.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.