1.. SPDX-License-Identifier: GPL-2.0-or-later 2 3Setting up the Mailing list 4=========================== 5 6Before using ``git send-email``, you need to set up your email client to send 7emails from the command line. This typically involves configuring an SMTP server 8and authentication details. 9 10Open a terminal and configure Git with your email settings using the following 11commands: 12 13.. code-block:: bash 14 15 git config --global sendemail.from "Your Name <[email protected]>" 16 git config --global sendemail.smtpserver "smtp.example.com" 17 git config --global sendemail.smtpuser "[email protected]" 18 git config --global sendemail.smtpserverport 587 19 git config --global sendemail.smtpencryption tls 20 21Replace ``smtp.example.com`` with the SMTP server address provided by your email 22provider. Replace ``[email protected]`` with your email address. Adjust the 23SMTP port and encryption settings according to your email provider's 24requirements. 25 26To test the configuration you can use ``--dry-run`` parameter. 27 28.. code-block:: bash 29 30 git send-email --dry-run --to "[email protected]" --subject "Test Email" --body "This is a test email." HEAD^ 31 32Depending on your SMTP server's configuration, you may need to authenticate 33before sending emails. If required, configure authentication settings using: 34 35.. code-block:: bash 36 37 git config --global sendemail.smtpuser "[email protected]" 38 git config --global sendemail.smtppass "your_password" 39 40Replace ``[email protected]`` with your email address and ``your_password`` 41with your email account password. 42 43For any corner case, please take a look at the 44`email + git <https://git-send-email.io/>`_ documentation. 45 46.. note:: 47 48 This method still works in most of the cases, but nowadays we often 49 require to setup a two factor authentication. If this is the case, please 50 consider setting up Git accordingly. 51