Skip to content

ihasmail documentation

ihasmail is webmail for Stalwart Mail Server. People get their mail, calendars, contacts and files in the browser, on a computer or a phone. The people running it get one small program that stores nothing of its own.

Try it first, with nothing to install: demo.ihasmail.com.

Where do you want to start?

I use ihasmail

  • Getting started

    Signing in, staying signed in safely, and what ihasmail does not do.

  • Mail

    Images, spam, read receipts, filters, undo — and using it on a phone.

  • Calendar · Contacts

    Events and invitations, address books and importing contacts.

  • Files · Sharing

    Your files on the mail server, and sharing them, calendars and address books with other people.

  • Settings

    Themes, language, dates, security, and making ihasmail your mail app.

  • Administration

    For admins: accounts, groups, lists, tenants, roles and domains.

  • Keyboard shortcuts

    Every shortcut, by screen. Press ? in the app for the same list.

I run ihasmail

  • Installing

    From nothing to signed in, in about ten minutes with Docker.

  • ihasmail-oneshot

    No mail server yet? Set up Stalwart and ihasmail together, in one command.

  • stalwart-migrator

    On Stalwart 0.15? Upgrade it to 0.16, the version ihasmail needs.

  • Configuring

    Every setting, and the few things Stalwart itself needs switched on.

  • Troubleshooting

    Find the problem by what you see, and what to change.

  • Rebranding

    Running it under your own name, and what the license asks of you.

I want to know how it works

  • Running immutably

    Why ihasmail can run with nothing saved to disk, and what that costs.

  • Network and ports

    Every connection from a browser to Stalwart, and the firewall rules that follow.

  • Sizing

    How big a server you need, and how many people one instance can serve.

Before you install

ihasmail needs Stalwart 0.16 or newer. No mail server yet? Use ihasmail-oneshot. On Stalwart 0.15? Upgrade it with stalwart-migrator.

Words you will meet

Stalwart
The mail server. It stores everything: mail, calendars, contacts, files and each person's settings.
JMAP
The modern standard ihasmail uses to talk to Stalwart, in place of older ones like IMAP. You never need to set it up.
Immutable
Running with nothing written to disk. Replacing ihasmail never loses anything, because there is nothing in it to lose.
Reverse proxy
A web server, such as nginx or Caddy, that sits in front of ihasmail and gives it an HTTPS address.
Sieve
The language Stalwart uses for mail filters. ihasmail builds the rules for you.
Tenant
A separate organization on the same mail server, with its own people, domains and administrator. A Stalwart Enterprise feature.

Elsewhere