Configure email notifications

In this tutorial, you will learn how to configure an SMTP provider in the ChainLaunch application. This process is essential for enabling email notifications for various events within the application. By following these steps, you will set up an SMTP provider that can send emails, ensuring you receive important updates about system events.

Prerequisites

• Access to the ChainLaunch application.
• Basic understanding of email settings (SMTP host, port, username, password).

Overview

Throughout this tutorial, you will:

1. Navigate to the monitoring section.
2. Add a new SMTP provider.
3. Fill in required fields such as provider name, SMTP host, port, and credentials.
4. Test the configuration to ensure it works properly.

---

Step 1: Click on 'Monitoring'

To begin configuring your SMTP provider:

1. Locate the left sidebar of the ChainLaunch interface.
2. Click on Monitoring.

Explanation:

This action takes you to the monitoring settings where you can manage notification providers.

---

Step 2: Click on 'Add Provider'

Next, you will add a new provider:

1. On the Monitoring page, find and click on Add Provider.

Explanation:

This opens a new form where you can enter details for your SMTP provider.

---

Step 3: Click on 'Provider Name'

You will now enter the name for your new provider:

1. In the form that appears, click on the field labeled Provider Name.

Explanation:

This field is where you will specify a recognizable name for your SMTP provider.

---

Step 4: Type 'MailPit' in Provider Name

Now, enter the name of your provider:

1. Type MailPit into the Provider Name field.

Explanation:

Choosing a clear name helps you identify this specific SMTP configuration later.

---

Step 5: Click on 'Set as Default Provider'

Designate this provider as your default:

1. Click on Set as Default Provider option to enable it.

Explanation:

Setting a default provider allows all notifications to be routed through this SMTP configuration by default.

---

Step 6: Click on 'SMTP Host'

Next, you'll configure the SMTP host:

1. Click on SMTP Host field.

Explanation:

The SMTP host is the server that will handle outgoing emails for your application.

---

Step 7: Type 'localhost' in SMTP Host

Enter the hostname for your SMTP server:

1. Type localhost into the SMTP Host field.

Explanation:

Using "localhost" indicates that your email server is running on the same machine as ChainLaunch.

---

Step 8: Click on 'SMTP Port'

Specify the port used for SMTP communications:

1. Click on SMTP Port field.

Explanation:

The port is essential for connecting to the specified SMTP server.

---

Step 9: Type '1025' in SMTP Port

Now, enter the port number:

1. Type 1025 into the SMTP Port field.

Explanation:

Port 1025 is commonly used for testing purposes and may not require authentication.

---

Step 10: Type 'notused' in SMTP Username

Next, enter the username for authentication:

1. Click into SMTP Username field.
2. Type notused.

Explanation:

This username is used for authenticating with your mail server.

---

Step 11: Type 'notused' in SMTP Password

Enter the password corresponding to your username:

1. Click into SMTP Password field.
2. Type notused.

Explanation:

This password is crucial for authenticating your connection to the mail server.

---

Step 12: Click on 'From Address'

Specify the sender's email address:

1. Click on From Address field.

Explanation:

This address will be displayed as the sender when notifications are sent out.

---

Step 13: Type 'dviejo@kfs.es' in From Address

Now enter your email address:

1. Type dviejo@kfs.es into the From Address field.

Explanation:

Using a valid email address ensures that recipients can reply or recognize messages correctly.

---

Step 14: Click on 'Use TLS'

Configure security settings for email transmission:

1. Locate and click on Use TLS toggle button to enable it.

Explanation:

TLS (Transport Layer Security) encrypts emails during transmission, providing an added layer of security.

---

Step 15: Click on 'Create Provider'

Finalize your setup by creating the provider:

1. Scroll down and click on Create Provider button.

Explanation:

This action saves all configurations you've made for your new SMTP provider.

---

Step 16: Click on 'Test'

You can now test your configuration:

1. Find and click on Test button next to your newly created provider entry.

Explanation:

Testing ensures that your configurations are correct and that emails can be sent successfully from this provider.

---

Step 17: Type 'dviejo@kfs.es' in Email Address

When prompted, specify where to send a test email:

1. Enter dviejo@kfs.es in the Email Address field of the prompt that appears after clicking Test.

Explanation:

This test helps verify if emails can be sent successfully to a specified address using this configuration.

---

Step 18: Click on 'Send Test Email'

Initiate sending a test email:

1. After entering your email address, click on Send Test Email button in the dialog box.

Explanation:

This action sends a test email through the configured SMTP settings to verify functionality.

---

Step 19: Capture Completed

Once testing is complete:

You will see confirmation indicating whether the test was successful or not.

Explanation:

If successful, you'll see a success message; if not, an error detailing what went wrong will be displayed.

---

Conclusion

Congratulations! You have successfully configured an SMTP provider within ChainLaunch and tested its functionality. You can now receive important email notifications about various events related to your application operations.

Tips & Best Practices

• Always ensure that you're using valid credentials when setting up an email provider.
• Utilize TLS encryption for better security.
• Test configurations before relying on them for critical notifications.
• Regularly check logs or notification settings to ensure proper functionality over time.