[00] INSTALLATION

Install LocalMail

Available for macOS, Windows, and Linux via package managers or direct download. Pick your platform below.

LocalMail supports macOS 12 Monterey and later. Universal binary runs natively on both Apple Silicon and Intel Macs.

Install via Homebrew for easy installation and future updates with a single command.

TERMINAL
$ brew install localmail-dev/tap/localmail

To update later: brew upgrade localmail

Download the DMG, open it, and drag LocalMail to your Applications folder.

Download LocalMail.dmg macOS 12+

Download the ZIP archive, extract it, and move LocalMail.app to your Applications folder.

Download LocalMail-mac.zip macOS 12+

LocalMail supports Windows 10 and Windows 11 (64-bit).

Install via Scoop for easy updates from the command line.

POWERSHELL
PS> scoop bucket add localmail https://github.com/localmail-dev/scoop-bucket
PS> scoop install localmail

To update later: scoop update localmail

Install via Chocolatey in an elevated PowerShell prompt.

POWERSHELL (ADMIN)
PS> choco source add -n=localmail -s="https://download.localmail.dev/chocolatey/"
PS> choco install localmail

To update later: choco upgrade localmail

Download the installer, run it, and follow the setup wizard.

Download LocalMail-Setup.exe Windows 10 / 11

LocalMail supports a wide range of Linux distributions via multiple package managers and formats.

Add the LocalMail APT repository. Supports Debian 11+ and Ubuntu 20.04+.

TERMINAL
$ curl -fsSL https://download.localmail.dev/apt/public.key | sudo gpg --dearmor -o /usr/share/keyrings/localmail.gpg
$ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/localmail.gpg] https://download.localmail.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/localmail.list
$ sudo apt update
$ sudo apt install localmail

To update later: sudo apt upgrade localmail

Add the LocalMail RPM repository. Supports Fedora 37+, RHEL 8+, CentOS Stream, and openSUSE.

TERMINAL
$ sudo rpm --import https://download.localmail.dev/rpm/public.key
$ sudo tee /etc/yum.repos.d/localmail.repo << 'EOF'
[localmail]
name=LocalMail
baseurl=https://download.localmail.dev/rpm/
enabled=1
gpgcheck=1
gpgkey=https://download.localmail.dev/rpm/public.key
EOF
$ sudo dnf install localmail

To update later: sudo dnf upgrade localmail

Install via Snap. Works on any Linux distribution with Snapd installed.

TERMINAL
$ sudo snap install localmail

Snap packages update automatically in the background.

Install from the Arch User Repository. Use an AUR helper or build manually.

WITH AN AUR HELPER

TERMINAL
$ yay -S localmail

MANUAL BUILD

TERMINAL
$ git clone https://aur.archlinux.org/localmail.git
$ cd localmail
$ makepkg -si

AppImage runs on any modern Linux distribution without installation. Download, make executable, and run.

TERMINAL
$ curl -LO https://download.localmail.dev/releases/latest/LocalMail.AppImage
$ chmod +x LocalMail.AppImage
$ ./LocalMail.AppImage

No root required. Move the file anywhere on your system to keep it.

Download and install the native package for your distribution directly.

DEBIAN / UBUNTU (.deb)

TERMINAL
$ curl -LO https://download.localmail.dev/releases/latest/LocalMail.deb
$ sudo dpkg -i LocalMail.deb

FEDORA / RHEL (.rpm)

TERMINAL
$ curl -LO https://download.localmail.dev/releases/latest/LocalMail.rpm
$ sudo rpm -i LocalMail.rpm

[01] NEXT STEPS

After installing

LocalMail starts a local SMTP server on localhost:1025 as soon as it launches. Point your application's SMTP settings there and every outbound email will be captured in the inbox.

Get LocalMail for $14.95

One-time purchase. macOS, Windows, and Linux. 14-day refund policy.

See pricing All features