diff --git a/install/elasticsearch/connect-configure-elasticsearch.rst b/install/elasticsearch/connect-configure-elasticsearch.rst index 69139eb7..b35c45e5 100644 --- a/install/elasticsearch/connect-configure-elasticsearch.rst +++ b/install/elasticsearch/connect-configure-elasticsearch.rst @@ -52,23 +52,31 @@ Elasticsearch user and password (Elasticsearch 8 and newer) $ zammad run rails r "Setting.set('es_password', '')" Add certificate to Zammad (Elasticsearch 8 and newer) - This step requires a running Zammad. If you are installing a new Zammad - instance, go on with the :doc:`installation <../package>` and come back here - when you can access the admin settings in the browser. + Add it via **Rails console**: + In case you are installing a new Zammad and didn't run through the + getting started wizard already, add the certificate via console: - Show and copy the auto-generated certificate from Elasticsearch and add it - to Zammad. Make sure to copy/paste the delimiters - (e.g. ``-----BEGIN CERTIFICATE-----``) too. + .. code-block:: console - .. code-block:: console + $ sudo cat /etc/elasticsearch/certs/http_ca.crt | zammad run rails r "SSLCertificate.create!(certificate: STDIN.read)" + + Add it via **UI**: + In case you already have a running and configured Zammad, you can add the + certificate in Zammad's + :admin-docs:`admin settings ` + (*Settings > Security > SSL Certificates*) as an alternative. + To show and copy the auto-generated certificate from Elasticsearch, run: + + .. code-block:: console + + $ sudo cat /etc/elasticsearch/certs/http_ca.crt - $ sudo cat /etc/elasticsearch/certs/http_ca.crt + To add it in Zammad, either upload the certificate file or paste the + content in the dialog. Make sure to copy/paste the delimiters + (e.g. ``-----BEGIN CERTIFICATE-----``) too. - To add it in Zammad, go to *Settings > Security > SSL Certificates* in the - :admin-docs:`admin settings ` and - add your copied certificate. Either upload the certificate file or paste the - content in the dialog. After saving the certificate, Zammad is now able to - connect to and access the Elasticsearch index. + In any case, you can find the certificate in the UI. This looks like + this: .. figure:: /images/install/elasticsearch/admin-certificate-management.png :alt: Screenshot shows certificate management in Zammad's admin panel