How can we help?

Watch this space: Upcoming Help Centre Migration


Password Recovery

Dominic -


How can I set up password recovery?


  • atmail suite
  • atmail mail server


Allow users to define a recovery email for password reset.


Create user for Password Recovery

  1. From your webadmin, create a user in your Account Manager. Since we are creating a specific user for password recovery, it is appropriate to create the user as '' or something similar. For this example I am using:
    • Username: noreply@fish.local
    • Domain: fish.local
    • Password: Snpg3h#o


Update atmail API.

  1.  Once the account is created, open your api.conf with your favored text editor.
    [root@mydomain ~]# vim /etc/atmail/api/api.conf
  2. Update the following variables to correspond to our newly created noreply user.
    ### Forgot Password

  3. Restart and check the status of your API server.
    [root@mydomain ~]# systemctl restart apiserver
    [root@mydomain ~]# systemctl status apiserver
    ● apiserver.service - atmail-api - jmap api for atmail webmail
    Loaded: loaded (/usr/lib/systemd/system/apiserver.service; enabled; vendor preset: disabled)
    Drop-In: /etc/systemd/system/apiserver.service.d
    Active: active (running) since Fri 2017-08-25 11:51:33 AEST; 2s ago
    Process: 2350 ExecStop=/bin/kill -s QUIT $MAINPID (code=exited, status=0/SUCCESS)
    Main PID: 2353 (apiserver)
    CGroup: /system.slice/apiserver.service
    └─2353 /usr/bin/apiserver -config /etc/atmail/api/api.conf

    Aug 25 11:51:33 systemd[1]: apiserver.service: main process exited, code=exited, sta...MENT
    Aug 25 11:51:33 systemd[1]: Unit apiserver.service entered failed state.
    Aug 25 11:51:33 systemd[1]: apiserver.service failed.
    Aug 25 11:51:33 systemd[1]: Started atmail-api - jmap api for atmail webmail.
    Aug 25 11:51:33 systemd[1]: Starting atmail-api - jmap api for atmail webmail...
    Hint: Some lines were ellipsized, use -l to show in full.

User Testing

  1. Login to your user account and find settings Screenshot_from_2017-08-25_15-20-57.png -> Accounts.
  2. Answer a minimum of three security questions.


  3. Designate a Recovery email address.


  4. Log-out and test.


  5. Confirm receipt of recovery email.



If you face any issues implementing this feature, the following logs will provide useful information as to why it may be failing.

  • /var/log/atmail/api.log
  • /var/log/maillog



Contact our support team

+61 (7) 5357 6605