Tracardi configuration
Tracardi configuration is performed via environment variables. You might want to use environment variables to change the default system configuration, especially if you intend to run Tracardi inside a Docker container. You can find the list of all the environment variable names below.
Elastic configuration
ELASTIC_HOST
- Default: 127.0.0.1. This setting defines an IP address of elastic search instance. SeeConnecting to elastic cluster
for more information how to connect to a cluster of servers.ELASTIC_SNIFF_ON_START
- Default: None. When you enable this option, the client will attempt to execute an Elasticsearch sniff request during the client initialization or first usage. Search documentation for sniffing to get more information.ELASTIC_SNIFF_ON_CONNECTION_FAIL
- Default: None. If you enable this option, the client will attempt to execute a sniff request every time a node is faulty, which means a broken connection or a dead node.ELASTIC_SNIFFER_TIMEOUT
- Default: None, Time out for sniff operation.ELASTIC_HTTP_AUTH_USERNAME
- Default: None. Elastic search username. Search for elastic authentication for more information on how to configure connection to elastic.ELASTIC_HTTP_AUTH_PASSWORD
- Default: None. Elastic search password. Search for elastic authentication for more information on how to configure connection to elastic.ELASTIC_SCHEME
- Default: http. Available options http, https.ELASTIC_CA_FILE
- Default: None. Elastic CA file. Search for elastic authentication for more information on how to configure connection to elastic.ELASTIC_API_KEY
- Default: None. Elastic API key. Search for elastic authentication for more information on how to configure connection to elastic.ELASTIC_CLOUD_ID
- Default: None. Search for elastic authentication for more information on how to configure connection to elastic.ELASTIC_MAX_CONN
- Default: None. Defines max connection to elastic cluster. It defaults to elastic default value.ELASTIC_HTTP_COMPRESS
- default value: None. Set compression on data when the client calls the server.ELASTIC_VERIFY_CERTS
- default value: None. Verify certificates when https schema is set. Set it to no if certificates has no CA.ELASTIC_REFRESH_PROFILES_AFTER_SAVE
- Default: no. When set to yes profile index will be forced to refresh its data after each update. That means that elastic will write all updates without buffering. This may slow the elastic significantly so be cautious with this setting.INSTANCE_PREFIX
- Default: None. It defines prefix for all elastic indexes. This can be used to run multiple instances of Tracardi on one elastic instance.ELASTIC_LOGGING_LEVEL
- Default WARNING. Sets logging level of elastic requests. It may be useful to set it to INFO when debugging Tracardi.
API settings
USER_NAME
- Default: admin. Login to Tracardi APIPASSWORD
- Default: admin. Password to Tracardi APIDEBUG_MAKE_SLOWER_RESPONSES
- Default: 0. This variable is for testing purposes only. It sets the number of seconds each endpoint should be slowed in order to see the GUI responses.AUTOLOAD_PAGE_SIZE
- Default: 25. Chunks of data that are loaded with one request.EXPOSE_GUI_API
- Default: yes. It exposes the GUI API on the started Tracardi API instance.
Plugins settings
RESET_PLUGINS
- Default: no. If set to yes it will remove plugins index with every start of Tracardi instance. This setting is used in development mode only.UPDATE_PLUGINS_ON_STARTUP
- Default: no. If equalsyes
it will update all installed plugins on Tracardi start.
Cache settings
REDIS_HOST
- Default: redis://localhost:6379. This setting is used only whenSYNC_PROFILE_TRACKS
is equal to yes. This is the host URI of Redis instance that is required to synchronize profile tracks. Available only in commercial version of Tracardi.SOURCE_CACHE_TTL
- Default: 60. Each resource read is cached for given seconds. That means that when you change any resource data, e.g. credentials it wil be available with max 60 seconds.CACHE_PROFILE
- Default: no. Profiles can be cached, but it is not recommended as this option is experimental.
Debugging settings
TRACK_DEBUG
- Default: no.LOGGING_LEVEL
- Default: WARNING
Event server configuration
SYNC_PROFILE_TRACKS
- Default: False. Available only in commercial version of Tracardi.RUN_HEARTBEAT_EVERY
- Default: 300. The time each worker reports its health.
Storage settings
STORAGE_DRIVER
- Default: elastic. There is only one storage driver available at this moment, and it is elastic.