Skip to content

Latest commit

 

History

History
83 lines (50 loc) · 2.88 KB

READMEMail.md

File metadata and controls

83 lines (50 loc) · 2.88 KB

Set up local mail server for development

PR #276 adds new features that require a mail server. Within this manual a local mail server under Windows 10 is set up, to use all functions within Budgeteer.

Download and install hMailServer

hMailServer can be downloaded from https://www.hmailserver.com/download.

For server types, Microsoft SQL Compact can be selected. An administrator password must be specified during installation. This must be entered when connecting to the server (IMPORTANT!).

hMailServer Administrator

After installation, hMailServer Administrator can be started.

A server with the host name localhost is created automatically, which we also use.

A double click connects to the server, but the password specified during installation must be entered.

Create domain

Under Domains and then on Add we create a new domain. As domain we use budgeteer.local.

Under the tab Advanced we set a catch-all address, namely [email protected].

Click on Save to save the new domain.

Create mail account

On the newly created domain, then Accounts and then on Add we create a mail account.

We use the same name for the address as for the catch-all address, namely [email protected].

A password must be selected.

Click on Save to save the mail account.

A second mail account with the name [email protected] should be created additionally.

Configure SMTP

Under Settings -> Protocols -> SMTP -> Delivery of e-mail, localhost must be entered in Local host name.

Click on Save to save the configuration.

The mail server can now be used.

Configure Outlook 2013

Under File -> Account Settings -> Account Settings... -> E-Mail -> New the address [email protected] can be added to Outlook.

Select Manual configuration or additional server types and then POP or IMAP.

Then configure as follows:

Now all messages to the mail server can be received via Outlook 2013.

Configure Budgeteer

Configure the application.properties in budgeteer-web-interface as follows:

  • budgeteer.mail.activate=true
  • spring.mail.host=localhost
  • spring.mail.port=25
  • spring.mail.username=[email protected]
  • spring.mail.password=PASSWORD FROM [email protected]
  • spring.mail.properties.mail.smtp.auth=true
  • spring.mail.properties.mail.smtp.starttls.enable=true

Deactivating mail functions

To deactivate the mail functions, budgeteer.mail.activate=false can be set. Then no mail server is needed anymore, because no more mails are sent, but you still have to, for example, enter a mail address when registering.