simple-login/app

What is it?

Key features

• 01Creates email aliases that forward mail to your real inbox.
• 02Browser extension and mobile apps can point to your own server's API URL.
• 03Runs as Docker containers with Postgres, Postfix and an email handler.
• 04Supports custom domains that point MX records to the server.
• 05Includes DKIM, SPF and DMARC setup guidance for better deliverability.

Use cases

• Hiding your real email address from online services and newsletters.
• Running a private alias service for yourself or a small team on your own domain.
• Keeping a self-hosted email forwarding setup under your control.

Quick start

1. 1

   Prepare a Linux server, a domain with DNS records, and Docker, following the README prerequisites and DNS sections

2. 2

   Create the data directories used by SimpleLogin

   mkdir sl
3. 3

   Create the Docker network used by the other containers

   sudo docker network create -d bridge --subnet=10.0.0.0/24 --gateway=10.0.0.1 sl-network
4. 4

   Start the Postgres database container (replace myuser and mypassword with your own credentials)

   docker run -d --name sl-db -e POSTGRES_PASSWORD=mypassword -e POSTGRES_USER=myuser -e POSTGRES_DB=simplelogin -p 127.0.0.1:5432:5432 -v $(pwd)/sl/db:/var/lib/postgresql/data --restart always --network="sl-network" postgres:12.1

Things to know

• !Self-hosting requires a Linux server, your own domain with DNS and mail records, and open port 25, plus Postfix setup.
• !The README recommends at least 2 GB of RAM because most components run in Docker containers.
• !The project is licensed under AGPL-3.0, a copyleft license that requires sharing modified source when offered over a network.

In collections

Topics

FAQ

What is app?

Self-hostable email alias service that forwards mail to your real inbox so you can keep your address private when signing up online. SimpleLogin is an email alias service. Instead of giving websites your real address, you create aliases that forward incoming mail to your inbox, so the same address is not used across services and you can be tracked less easily. The project includes a web app, a Chrome/Firefox extension and mobile apps, and it can be self-hosted on your own server.

Is app free to use? What license does it have?

app is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is app still maintained?

Actively maintained. The last commit to app was on Oct 22, 2026.

What can I use app for?

Hiding your real email address from online services and newsletters. Running a private alias service for yourself or a small team on your own domain. Keeping a self-hosted email forwarding setup under your control.

How do I install app?

Prepare a Linux server, a domain with DNS records, and Docker, following the README prerequisites and DNS sections Create the data directories used by SimpleLogin: mkdir sl Create the Docker network used by the other containers: sudo docker network create -d bridge --subnet=10.0.0.0/24 --gateway=10.0.0.1 sl-network Start the Postgres database container (replace myuser and mypassword with your own credentials): docker run -d --name sl-db -e POSTGRES_PASSWORD=mypassword -e POSTGRES_USER=myuser -e POSTGRES_DB=simplelogin -p 127.0.0.1:5432:5432 -v $(pwd)/sl/db:/var/lib/postgresql/data --restart always --network="sl-network" postgres:12.1

Where can I get app?

The source code and installation instructions are on GitHub: https://github.com/simple-login/app