diff --git a/.github/workflows/generic_publish.yml b/.github/workflows/generic_publish.yml index c64a150..919dfd5 100644 --- a/.github/workflows/generic_publish.yml +++ b/.github/workflows/generic_publish.yml @@ -24,9 +24,12 @@ jobs: - name: 'Prepare tags' id: prep uses: docker/metadata-action@v6.0.0 + env: + DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }} with: images: | ghcr.io/${{ github.repository }} + ${{ env.DOCKER_USERNAME != '' && 'webyhomelab/docker-mailserver-gui' || '' }} tags: | type=edge,branch=master type=semver,pattern={{major}} diff --git a/README.md b/README.md index 8656d25..790cbce 100644 --- a/README.md +++ b/README.md @@ -69,6 +69,19 @@ flowchart LR --- +## 📸 Interface Preview + +

+ Docker Mailserver GUI - Webmail Login Screen + Docker Mailserver GUI - Mailbox Inbox Interface +

+

+ Docker Mailserver GUI - Email Composition View + Docker Mailserver GUI - Settings and Account Configuration +

+ +--- + ## 🚀 Quick Start Deploying your secure mail server takes less than 5 minutes. @@ -113,10 +126,16 @@ docker exec -ti dms-core setup email add user@yourdomain.com - **Instant Inbound:** `Postgrey` (greylisting) is disabled by default to allow immediate email delivery without the standard 10-minute delay. - **Docker 29+ Compatibility:** Explicitly configured Traefik with `DOCKER_API_VERSION=1.41` to support modern container engines. - **No Hardcoded Passwords:** The Supervisor UNIX socket credentials have been removed to prevent local privilege escalation. -- **Automatic Sync:** SSL certificates are reloaded automatically by the dumper without stopping the mail server. +- **Automatic SSL Sync:** SSL certificates are monitored and reloaded automatically by the `dms-cert-dumper` sidecar using a highly robust `alpine:3.18`-based image equipped with `docker-cli`. +- **Persistent Webmail Config:** SnappyMail data is explicitly persisted to `./snappymail-data` on the host, preventing the loss of settings/accounts across restarts. +- **Dual Registry Publishing:** Automatic package deployment publishes container images to both GitHub Container Registry (GHCR) and Docker Hub (`webyhomelab/docker-mailserver-gui`). --- +### ⚖️ Legal Disclaimer + +*All product names, logos, brands, and trademarks referenced in this repository are the property of their respective owners. All company, product, and service names used in this project are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.* +

Built in Ukraine under air raid sirens & blackouts ⚡
diff --git a/SECURITY.md b/SECURITY.md index ffdfb76..a17c9f3 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -33,6 +33,6 @@ We aim to acknowledge all reports within 48 hours and provide a fix or mitigatio ## Security Audit Status -- **Static Analysis:** The codebase is regularly scanned with `hadolint`, `shellcheck`, and `eclint`. -- **Dependency Scanning:** We use `OSV-Scanner` and GitHub dependabot to monitor for vulnerable packages. -- **Manual Audit:** The `supervisord.conf` and `setup.sh` scripts have been manually audited for credential leaks as of May 2026. +- **Static Analysis:** The codebase is regularly scanned with `hadolint`, `shellcheck`, and `eclint` to ensure shell scripts and Dockerfiles adhere to security guidelines. +- **Dependency Scanning:** We use `OSV-Scanner`, GitHub Dependabot, and vulnerability-scan actions to monitor for CVEs in base images and packages. +- **Manual Audit:** The `supervisord.conf` process manager and `setup-gui.sh` configuration scripts have been manually audited for privilege escalation paths and credential leaks as of the `v0.9.6` release in May 2026. diff --git a/docker-mailserver-gui-1.png b/docker-mailserver-gui-1.png new file mode 100644 index 0000000..77a494c Binary files /dev/null and b/docker-mailserver-gui-1.png differ diff --git a/docker-mailserver-gui-2.png b/docker-mailserver-gui-2.png new file mode 100644 index 0000000..0a971c2 Binary files /dev/null and b/docker-mailserver-gui-2.png differ diff --git a/docker-mailserver-gui-3.png b/docker-mailserver-gui-3.png new file mode 100644 index 0000000..4ce3fb7 Binary files /dev/null and b/docker-mailserver-gui-3.png differ diff --git a/docker-mailserver-gui-4.png b/docker-mailserver-gui-4.png new file mode 100644 index 0000000..ed805bc Binary files /dev/null and b/docker-mailserver-gui-4.png differ