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.
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!).
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.
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 all@budgeteer.local.
Click on Save to save the new domain.
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 all@budgeteer.local.
A password must be selected.
Click on Save to save the mail account.
A second mail account with the name noreply@budgeteer.local should be created additionally.
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.
Under File -> Account Settings -> Account Settings... -> E-Mail -> New the address all@budgeteer.local can be added to Outlook.
Select Manual configuration or additional server types and then POP or IMAP.
Then configure as follows:
- Your name: Max Mustermann
- E-mail address: all@budgeteer.local
- Account type: POP3
- Incoming mail server: localhost
- Outgoing mail server (SMTP): localhost
- Username: all@budgeteer.local
- Password: PASSWORD FROM all@budgeteer.local
Now all messages to the mail server can be received via Outlook 2013.
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=noreply@budgeteer.local
- spring.mail.password=PASSWORD FROM noreply@budgeteer.local
- spring.mail.properties.mail.smtp.auth=true
- spring.mail.properties.mail.smtp.starttls.enable=true
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.