jcoffey-dev
ad8bd02f13
ghcr.io went dark with the GitHub account, so every `docker pull` and template that named it has been failing. The images are republished, multi-arch as before, at registry.coffeylabs.org under the same names, and pull anonymously -- nothing needs a login. Where a link pointed at an issue list, it now goes to /-/work_items: in GitLab 19 that is the public list, and /-/issues returns 404 to anyone not signed in. Issues themselves did not come across from GitHub, so a link to a specific old issue is replaced with a note saying where it was.
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# Coffey Labs Unraid templates
|
|
|
|
Docker templates for [Unraid Community Applications](https://ca.unraid.net),
|
|
one XML file per app under `templates/`. `ca_profile.xml` at the root is what
|
|
Community Applications reads for the repository listing.
|
|
|
|
| App | Template | Image | Licence of the app |
|
|
| --- | --- | --- | --- |
|
|
| [ihasmail](https://ihasmail.org) — immutable webmail for Stalwart Mail Server | [`templates/ihasmail.xml`](templates/ihasmail.xml) | `registry.coffeylabs.org/coffey-labs/ihasmail:latest` (amd64, arm64) | AGPL-3.0-or-later |
|
|
|
|
## Installing
|
|
|
|
Once the repository is accepted into Community Applications, search for the
|
|
app under **Apps** and install it from there.
|
|
|
|
Until then, or if you prefer to skip the store, copy the template onto the
|
|
flash drive from the Unraid terminal and it appears under **User templates**
|
|
in the **Template** drop-down of **Docker → Add Container**:
|
|
|
|
```sh
|
|
wget -P /boot/config/plugins/dockerMan/templates-user/ \
|
|
https://git.coffeylabs.org/coffey-labs/unraid-templates/-/raw/main/templates/ihasmail.xml
|
|
```
|
|
|
|
## ihasmail
|
|
|
|
ihasmail is a mail client, not a mail server. It needs a
|
|
[Stalwart Mail Server](https://stalw.art) 0.16 or newer that the container can
|
|
reach, and nothing else: no database, no appdata to migrate, no IMAP or SMTP
|
|
settings. Everything durable lives in Stalwart.
|
|
|
|
The template runs the container read-only, as Unraid's `nobody` user, with a
|
|
`/tmp` in memory. The one optional write is `sessions.json` under
|
|
`/mnt/user/appdata/ihasmail`, kept so nobody is signed out when the container
|
|
restarts or updates. Clear that path, blank `SESSION_FILE` and set
|
|
`IMMUTABLE=1` to run with no writable path at all, which is how
|
|
[ihasmail.com](https://ihasmail.com) runs it.
|
|
|
|
Two things to set on first install:
|
|
|
|
- **Stalwart URL** — scheme and host, no path, e.g. `https://mail.example.com`.
|
|
- **App secret** — a long random string. In the Unraid terminal:
|
|
`openssl rand -base64 48`.
|
|
|
|
Put it behind a reverse proxy with HTTPS before exposing it beyond your LAN.
|
|
Every other setting is documented at
|
|
[docs.ihasmail.org/configure](https://docs.ihasmail.org/configure/).
|
|
|
|
Problems with the app go to
|
|
[coffey-labs/ihasmail issues](https://git.coffeylabs.org/coffey-labs/ihasmail/-/work_items);
|
|
problems with the template go to the issues on this repository.
|
|
|
|
## Licence
|
|
|
|
The templates in this repository are MIT licensed. Each app keeps its own
|
|
licence, shown in the table above.
|