- Elastic Docs/
- Deploy and manage/
- Deploy/
- Elastic Cloud Enterprise/
- Manage deployments/
- Configure/
- Edit stack settings
Add Elasticsearch user settings
Change how Elasticsearch runs by providing your own user settings. User settings are appended to theelasticsearch.yml configuration file for your cluster and provide custom configuration options.
If a feature requires both standardelasticsearch.yml settings andsecure settings, configure the secure settings first. Updating standard user settings can trigger a cluster rolling restart, and if the required secure settings are not yet in place, the nodes might fail to start. Adding secure settings does not trigger a restart.
Elastic Cloud Enterprise automatically rejectselasticsearch.yml settings that could break your cluster, including some zen discovery and security settings. For a detailed list of settings, refer to theElasticsearch configuration reference.
Most of the user settings that are available for the Elasticsearch version that your cluster is running are also available on Elastic Cloud Enterprise, regardless of being marked as "supported on Elastic Cloud Hosted".
To add or edit Elasticsearch user settings:
On theDeployments page, select your deployment.
Narrow the list by name, ID, or choose from several other filters. To further define the list, use a combination of filters.
From your deployment menu, go to theEdit page.
In theElasticsearch section, selectManage user settings and extensions. For deployments with existing user settings, you may have to expand theUser setting overrides caret for each node type instead.
Update the user settings.
SelectSave changes.
WarningIf you encounter theEdit elasticsearch.yml carets, be sure to make your changes on all Elasticsearch node types.
To enable email notifications in your Elasticsearch cluster, you need to configure an email account and related settings. For complete instructions, refer toConfiguring email accounts.
xpack.notification.email.account: gmail_account: profile: gmail smtp: auth: true starttls.enable: true host: smtp.gmail.com port: 587 user: <username>Before you add thexpack.notification.email* user settings, make sure to store the SMTP password in the keystore as asecure setting. In the previous example, use the keyxpack.notification.email.account.gmail_account.smtp.secure_password.