You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The `mail` quickstart demonstrates how to send and receive emails using CDI and JSF and with custom Mail provider configured in {productName}.
@@ -40,34 +41,28 @@ To run the Mail Quickstart, you need a Mail Server configured with the following
40
41
41
42
In addition, the Mail Subsystem configuration and the test cases expect you have the following Mail accounts configured on your Mail Server:
42
43
43
-
- user01@james.local
44
-
- user02@james.local
44
+
- user01@mail.local
45
+
- user02@mail.local
45
46
46
-
You can use any Mail Server you consider, although to facilitate this task, you will find under the Mail Quickstart root directory a docker compose file prepared to launch an Apache James Mail server with all the required configuration. You will need to have installed a Container Engine capable of work with Docker compose files and Linux images. The following command assumes you have https://podman.io/[Podman] and https://docs.podman.io/en/latest/markdown/podman-compose.1.html[Podman Compose] installed in your local environment.
47
+
You can use any Mail Server you consider, although to facilitate this task, you will find under the Mail Quickstart root directory a docker compose file prepared to launch a Greenmail mail server with all the required configuration.
48
+
You will need to have installed a Container Engine capable of working with Docker compose files and Linux images.
49
+
The following command assumes you have https://podman.io/[Podman] and https://docs.podman.io/en/latest/markdown/podman-compose.1.html[Podman Compose] installed in your local environment.
47
50
48
-
To launch the Apache James Mail server, open the terminal and navigate to the Mail Quickstart root directory and execute the following:
51
+
To launch the Greenmail server, open the terminal and navigate to the Mail Quickstart root directory and execute the following:
49
52
50
-
```
53
+
[source, bash]
54
+
----
51
55
$ podman compose up --wait
52
56
>>>> Executing external compose provider "/usr/local/bin/docker-compose". Please refer to the documentation for details. <<<<
57
+
----
53
58
54
-
[+] Running 1/1
55
-
✔ Container apache-james Healthy
56
-
```
57
-
58
-
NOTE: The Apache James server is configured without allowing the relay of the emails to external addresses that are not configured in the server. When you are sending / receiving emails with this server, you have to use the accounts shipped with the apache James demo image. These are the accounts available out of the box: [email protected], [email protected] and [email protected].
59
-
All accounts use the same password: `1234`
60
-
61
-
Once you have finished with the Mail Quickstart, you can shutdown and remove the Apache James Mail server with the following command:
59
+
Once you have finished with the Mail Quickstart, you can shutdown and remove the Greenmail server with the following command:
62
60
63
-
```
61
+
[source, bash]
62
+
----
64
63
$ podman compose down --volumes
65
64
>>>> Executing external compose provider "/usr/local/bin/docker-compose". Please refer to the documentation for details. <<<<
66
-
67
-
[+] Running 2/1
68
-
✔ Container apache-james Removed
69
-
✔ Network mail_default Removed
70
-
```
65
+
----
71
66
72
67
// Back Up the {productName} Standalone Server Configuration
The application will be running at the following URL: http://localhost:8080/{artifactId}/[http://localhost:8080/{artifactId}/^].
153
147
154
148
NOTE: If you see `Error processing request` in the browser when you access the application and attempt to send email, followed by `jakarta.servlet.ServletException: MailConnectException: Couldn't connect to host, port: localhost, 1025; timeout -1; nested exception is: java.net.ConnectException: Connection refused`, make sure you followed the instructions above to xref:configure_an_smtp_server_on_your_local_machine[Configure an SMTP Server on Your Local Machine].
155
-
156
-
NOTE: If you are using the Mail server shipped with this Quickstart and see `Error sending the Email. Invalid Addresses` in the browser when you attempt to send email, make sure you are sending your email to an existing account configured in the Mail Server since by default Apache James demo image is shipped with relay disabled. By default, Apache James demo image has the following accounts configured: [email protected], [email protected] and [email protected].
0 commit comments