Deploy JMAP Webmail

Self-hosted JMAP webmail for Stalwart, Fastmail, Cyrus or Apache James

Deploy JMAP Webmail

Just deployed

/app/.data

Deploy and Host JMAP Webmail on Railway

Deploy on Railway

A modern webmail for any JMAP server. Stalwart is a superb mail server that ships without a webmail UI; Fastmail, Cyrus and Apache James speak JMAP too. This template is a fast, offline-capable JMAP mail client you point at your server — one container, two variables, done.

About Hosting JMAP Webmail

A single SvelteKit (Node) service with a volume at /app/.data for its SQLite store: sessions, rate limits, settings and push subscriptions. Set PUBLIC_JMAP_SERVER_URL to your Stalwart server's base URL (e.g. https://mail.example.com) — everything else has working defaults, and SESSION_SECRET is auto-generated. Your users sign in with their mailbox email + password (app passwords and password$totp TOTP suffixes work); credentials are AES-256-GCM-sealed in a server-side SQLite store, the browser cookie only ever holds an opaque session id, and all JMAP traffic is proxied same-origin. The client is Zaur Mail 2: mail, calendar, contacts, files and server-side filter rules in one app, with optional video calls (Meet), drafts and an outbox that keep working offline, live updates over JMAP push, and phone and tablet layouts. It installs as a PWA. There's a Stalwart template on Railway too — deploy both for a complete self-hosted mail stack.

Common Use Cases

  • Give a self-hosted Stalwart server the webmail UI it doesn't ship with
  • Small teams and families running their own mail who want a fast, modern client with calendars, contacts, files and vacation responses
  • Video calls from a calendar event, with guests joining from a link, once you add a LiveKit Cloud project
  • A browser and phone client for any JMAP account, with new-mail push notifications once you add VAPID keys

Dependencies for JMAP Webmail Hosting

  • A JMAP mail server — Stalwart, Fastmail, Cyrus or Apache James. This is a client, it does not run a mail server
  • Everything else is bundled: one service, one volume, no database to manage

Deployment Dependencies

Implementation Details

Recommended: Stalwart OAuth. With OAuth the server stores revocable tokens instead of the password:

  1. In Stalwart, register an OAuth client — redirect URI https://‹your-webmail-domain›/api/auth/oauth/callback, PKCE S256. Stalwart 1.0 refuses clients it doesn't know, so sign-in fails without this. In its admin UI that's Directory → OAuth Clients → Create. On 1.0.3 and later, list the scopes mail, contacts, calendars, files and security, or sign-in fails with invalid_scope. On earlier 1.0 versions, turn on First-party application under Access instead.
  2. Set STALWART_OAUTH_ENABLED=true, STALWART_OAUTH_ISSUER_URL (usually your JMAP URL) and STALWART_OAUTH_CLIENT_ID.
  3. Password sign-in disables itself automatically.

Notes:

  • Stalwart versions: works with Stalwart 0.16.27 and 1.0. A move to 1.0 ends OAuth sign-ins, so everyone signs in again; register the client first if it never was. A move to 1.0.3 also signs first-party sessions out once, and the client needs the scopes above first.
  • Push notifications: generate keys with npx web-push generate-vapid-keys and set VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY and VAPID_SUBJECT. Without them the app still updates live while open; it just can't notify when closed.
  • Video calls: create a LiveKit Cloud project and set LIVEKIT_URL, LIVEKIT_API_KEY and LIVEKIT_API_SECRET. Calendar then offers a Video call switch, and guests join from the link without an account. Without all three, Meet stays off.
  • The interface is neutral "Webmail" by default; rebrand it with PUBLIC_APP_NAME, PUBLIC_BRAND_NAME, PUBLIC_MAIL_DOMAIN and PUBLIC_APP_ICON.
  • Calendars, quotas and vacation responses are feature-probed, so the client degrades gracefully with your server configuration.
  • Other JMAP servers: set JMAP_AUTH=basic for Cyrus or Apache James, or JMAP_AUTH=token for Fastmail (users paste an API token as the password, PUBLIC_JMAP_SERVER_URL=https://api.fastmail.com/jmap/session). Calendar, contacts, files, filters and vacation replies only appear when the server offers them.
  • Signup and password-reset flows stay hidden unless you wire the optional register service — manage accounts in Stalwart directly.
  • PORT=3000, HOST=:: (dual-stack for Railway networking) and RAILWAY_RUN_UID=0 (volume write access) are pre-configured — leave them as they are.

Why Deploy JMAP Webmail on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying JMAP Webmail on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0