Skip to content

JSONbored/simplelogin-aio

Repository files navigation

simplelogin-aio

SimpleLogin packaged as a true All-In-One Unraid container.

simplelogin-aio bundles the SimpleLogin web app, background jobs, inbound email handler, Postfix, PostgreSQL, and Redis into a single container with Unraid-friendly persistence. A normal install only needs one image, one /appdata mapping, and the usual domain + DNS setup required by any self-hosted mail stack.

What This Repo Ships

Included Services

  • SimpleLogin web UI on port 7777
  • Postfix for inbound SMTP on port 25
  • Embedded PostgreSQL inside the container
  • Embedded Redis inside the container
  • SimpleLogin email handler and background job runner

Important Runtime Notes

  • Current upstream SimpleLogin container support is linux/amd64 only, so simplelogin-aio currently publishes amd64-only images.
  • First boot initializes PostgreSQL, writes the runtime .env, applies alembic upgrade head, and then runs init_app.py.
  • /appdata is the main persistent volume. /pgp is optional for advanced PGP usage.
  • If you already run external PostgreSQL or Redis, set DB_URI and REDIS_URL in the Unraid template and the internal daemons will stay idle.

Quick Start

  1. Install the Unraid template.
  2. Set URL, EMAIL_DOMAIN, SUPPORT_EMAIL, and FLASK_SECRET.
  3. Pick a relay mode if your ISP blocks outbound port 25.
  4. Forward inbound TCP port 25 to the Unraid host if you want aliases to receive internet mail.
  5. Review docs/simplelogin-setup.md for the required DNS records and mail-routing checklist.

Validation

Local validation completed on March 29, 2026:

  • explicit linux/amd64 Docker build succeeded
  • full local smoke test passed end-to-end
  • restart and persistence coverage added to the smoke test
  • internal PostgreSQL, Redis, web, background jobs, and Postfix all validated in the same container
  • workflow hardening added with pinned action SHAs, dependency review, and upstream release tracking

Releases

simplelogin-aio uses upstream-version-plus-AIO-revision releases such as v4.79.0-aio.1.

Every main build publishes latest, the exact pinned upstream version, an explicit packaging line tag, and sha-<commit>.

See docs/releases.md for the release workflow details.

Support

Funding

If this work saves you time, support it here:

Star History

Star History Chart

About

SimpleLogin All-in-One Docker image for Unraid — self-host your own email alias service with automatic DKIM, database migrations, and s6-overlay process supervision

Topics

Resources

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors