# Awesonix Mail

Awesonix Mail is a self-hosted webmail aggregator for homelab users that centralizes mailbox access with a separately managed external database service. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/8917/awesonix-mail

## Description

Awesonix Mail is a self-hosted webmail aggregator for homelab users that centralizes mailbox access with a separately managed external database service.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

44/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 2 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/awesonix-mail-1i1d4ep1yhyk5p?q=Awesonix-Mail
- GitHub: https://github.com/awesonix-com/awesonix-mail

## Common questions

### Do I need to set the database host and password before first launch?

No, database settings are optional in every template. If they are left empty, the first-run wizard asks for them in its first step and shows schema build progress.

### What stop-timer setting should the container use?

Use a stop grace period of at least 120 seconds, matching the platform templates.

### Which files should I back up for database settings?

Back up database.json from the secrets folder together with master.key.

### Should I expose the token-gated diagnostics listener normally?

No, it is off by default and no variant publishes TCP port 8182. Enable it and publish the port only for a diagnostic session on a trusted network.

### What should I read before upgrading?

Read the changelog before every upgrade. It lists each version with its upgrade steps, commands, and changes for administrators.

### How do I verify an offline installation package?

The release includes an offline image archive with SHA256SUMS. Verify the archive and checksums against the release before tagging and installing it on your platform.

---
Source: Our Local Host (https://ourlocalhost.com/app/8917/awesonix-mail), the self-hosted and open-source app directory.
