Boogie
A mail client · macOS · iOS · iPadOS · watchOS

♦ Boogie Support

Get help by email

Email support@boogie.digital and we'll reply within 2 business days (AEST). Include your Boogie version, device and OS, and a short description of the issue — screenshots help.

Email support@boogie.digital

Help topics

Getting started

Boogie is a native JMAP email and calendar client. To use it you need a mailbox on a JMAP server — self-hosted Stalwart Mail Server, Fastmail, or any provider that speaks RFC 8620.

Add your first account

  • Open Boogie and enter your email address. Boogie works out who your provider is and shows Sign in with … — tap it to sign in on your provider's own secure page. Boogie never sees that password.
  • Prefer a password or an app token? Choose Use a password or token instead.
  • If Boogie can't find your server, choose Specify server manually and enter its address (for example mail.example.com).

Fastmail New in 1.4

Enter your Fastmail address and choose Sign in with Fastmail. Approve access on Fastmail's page and you're done — mail, calendars, and contacts. An API token still works if you'd rather use one: choose Use a password or token instead.

Stalwart and other self-hosted servers

Use your full email address. If your server offers sign-in through its own page, Boogie uses it; otherwise enter your password. If sign-in fails, confirm the server has JMAP enabled and is reachable from your device — see Troubleshooting.

More than one account

Boogie supports multiple accounts side by side — add more from Settings → Accounts. Each account keeps its own mailboxes, identities, and sync. Boogie is free to try for 14 days; see Subscription & trial.

Mail

Reading

Remote images are blocked by default. When a message contains them, Boogie shows a banner — tap Load Images to fetch them for that message only. You can change the policy any time in Settings (always load, ask, or never).

Group a thread into one conversation, or read every message on its own — your choice in Settings.

Search Improved in 1.4

Search checks the mail on your device and your server together, so it covers your whole mailbox. Narrow it down with from:, to:, subject:, or body: — for example from:alice invoice. Put phrases in quotes. Deleted mail stays out of the results unless you're searching Trash. On the Mac, ⌘F jumps to the search field.

Tags

Tag messages, and rename or delete tags as you go. Tags live on the server, so they follow you to every device.

Organising your mail

Archive, delete, move, and flag from the message list or an open message. Select several messages at once to act on them together. On iPhone and iPad you can set your own swipe actions in Settings; on the Mac you can also print. See Writing & sending and Settings & accounts.

Rules New in 1.4

Sort incoming mail automatically in Settings → Rules: choose the account, then build rules that file, flag, or act on messages as they arrive. Boogie saves them to your server, so they keep working when Boogie is closed. Rules need a server that supports mail filtering (Sieve), such as Stalwart.

Contacts New in 1.4

View, edit, and create contacts from your server's address book. On Stalwart you can also create contact groups.

Spotlight

Your mail shows up in system search — find a message from the Home Screen or the Mac Spotlight bar and jump straight to it.

Shared folders Work in progress

You may spot Share Folder… when you right-click a folder. It's an early version: for now it can only share with another of your own accounts on the same server.

Writing & sending

Compose from the toolbar or with ⌘N. Reply, reply-all, and forward from any open message.

From address

If you have more than one identity — or more than one account — choose the From address in the compose window. Replies default to the address the message was sent to.

Attachments

Add files by dragging them into the window on the Mac, or with the Files picker on iPhone and iPad. On the Mac you can also paste or drop a screenshot — it's added as an attachment.

Scheduled send

Not ready to send yet? Pick a date and time, and Boogie sends the message for you later.

Undo send

Boogie holds each message briefly after you press Send, so you can pull it back. Set the delay in Settings — off, or up to 30 seconds.

Send Again and drafts

Send Again reopens a message from your Sent mailbox as a fresh copy. Open any draft to carry on where you left off. Your signature is added automatically — see Signatures.

Signatures

Give each identity its own HTML signature. Edit them in Settings → Signatures with a rich editor — text, links, even an inline image — then assign one to each identity, so the right signature is added to every message you send.

Want the same signatures on all your devices? Turn on iCloud signature sync in Settings. It's off by default.

Calendar

Boogie includes a native JMAP calendar — no separate CalDAV account, same server, same sign-in.

  • Views — Day, Week, and Month.
  • Go anywhere — jump to any date, or snap back to today (⌘T on the Mac).
  • Events — create, edit, and delete events, including repeating events and events with invitees.
  • Colours — pick a colour per calendar; it's saved to your server, so it follows you to every device.
  • Defaults — set a default event length, a default alert, and the day your week starts.

Invitations & RSVP

When an invitation arrives in your mail, reply Accept, Decline, or Maybe right from the message, and add the event to your calendar in a tap.

Server support Fastmail in 1.4

The calendar works wherever your server offers JMAP calendars. Stalwart Mail Server and Fastmail both do. On Fastmail, calendars come with Sign in with Fastmail. If you added Fastmail with an API token and your calendars don't appear, remove the account and add it again with Sign in with Fastmail.

Vacation auto-reply

Going away? Turn on an auto-reply in Settings → Vacation: write a subject and message, and — if you like — set start and end dates so it switches itself on and off.

The auto-reply is stored on your server, so it keeps running even when Boogie is closed. It's available wherever your server supports vacation responses.

Notifications

Boogie lets you know when new mail arrives, and tapping a notification opens the message. Allow notifications when Boogie first asks, or any time afterwards from your device's system Settings. The unread count shows on the app badge.

Choose which folders notify you New in 1.4

By default only your Inbox notifies you — Junk, Archive, and folders your server's filters sort mail into stay quiet. To add a folder, go to Settings → Accounts → your account → Notifications and switch it on.

Boogie Push New in 1.4

On iPhone and iPad, Boogie Push is an optional add-on that brings new-mail notifications even when Boogie is fully closed — and your mail stays private: we can't read it. Subscribe in Settings → Subscription → Subscribe to Boogie Push; it switches itself on once the subscription is active. It's a separate subscription from your Boogie plan — see pricing. On the Mac, Boogie notifies you while it's running.

Settings & accounts

Accounts

Add or remove accounts, and switch between them, in Settings → Accounts. Each account has its own page for identities, notifications, and Apple Watch. If folders look wrong, Repair Server Folders creates any standard folders that are missing and reports duplicates. Where your server reports it, you'll also see your storage quota.

When you remove an account, Boogie tells you first whether it's being removed from just this device or from every device that shares your iCloud Keychain.

Reading and sync

Tune how mail looks and syncs: font size, list density (Compact, Cozy, Standard, or Relaxed), contact photos, and whether threads group into conversations. Sync depth controls how far back Boogie pulls — all mail, the last year, the last 90 days, or the last 30.

Read receipts

When a message asks for a read receipt, Boogie can ask you before sending one, or never send them — set it in Settings.

Vacation and Rules

Both live on your server and have an account picker, so you can set each account separately. See Vacation auto-reply and Rules.

iCloud Keychain

Your account settings sync securely across your Apple devices through iCloud Keychain — on by default, so a new device picks up your accounts without re-entering everything. Apple Watch also relies on it — see Apple Watch. Turn it off in Settings if you'd rather keep each device separate.

Keyboard shortcuts

Boogie is built for the keyboard on the Mac — and the same shortcuts work on iPad with a hardware keyboard.

j / kNext / previous message
↑ / ↓Move selection (Mac)
↩Open message in its own window (Mac)
⌘ASelect all
⇧-click / ⌘-clickExtend selection / add or remove a message
⌘RReply
⌘⇧RReply All
⌘⇧FForward
⌘FSearch
⌫Delete
⌃⌘AArchive
⌘⇧UToggle read / unread
⌘⇧\Toggle flag
⌘⇧LMove to folder
⌘NNew message — or new event in Calendar
⌘SSend (in the compose window)
⌘ZUndo send, while the send delay is running
⌘YSync now
⌥⌘NGet new mail for every account
⌘TGo to today (Calendar)
⌃⌘SShow or hide the sidebar
?, or ⇧⌘/ on Mac and ⌘/ on iPadShow every shortcut

Press ? in the app for the full, always-current list.

Apple Watch

Boogie runs on Apple Watch. See your unread count and latest messages, then reply, mark read or unread, flag, or delete — or compose a new message from your wrist. Quick actions let you sync now or mark everything read.

Set up Changed in 1.4

  1. Add your account in Boogie on your iPhone (or Mac) first, and keep iCloud Keychain sync turned on in Settings — the Watch finds your accounts through it.
  2. Open Boogie on the Watch. If your account signs in through your provider's page, the Watch asks for its own sign-in: tap Sign in on Watch and pick the account.
  3. The Watch shows a short code. On your iPhone or Mac, open the web address the Watch shows (it ends in /device), enter the code, and approve. The Watch finishes by itself.

Accounts that use a password or token need no extra step — the Watch uses the one from iCloud Keychain. To check an account, open Settings → Accounts → your account → On Watch.

Fastmail on the Watch

Fastmail's sign-in page doesn't offer the code step the Watch needs, so an account added with Sign in with Fastmail can't be used on the Watch yet. If you want Fastmail on your wrist, add it with an API token instead (Use a password or token instead) — the Watch can use your first password or token account.

If the Watch says Open Boogie on iPhone to set up your account, it can't see any accounts yet: check that iCloud Keychain sync is on and that you've added an account on your iPhone.

Subscription & trial

Boogie is free to try for 14 days — every feature, on every platform. The 14 days start when you first download Boogie with your Apple Account, and a banner shows how many are left.

When the trial ends Changed in 1.4.6

Boogie locks until you choose a plan. Your mail, calendars, and contacts stay on your device and your server — nothing is deleted — and subscribing or buying Lifetime unlocks everything straight away. From the lock screen you can also restore an earlier purchase, remove your account, or contact support.

Plans

Pick an annual subscription or a one-time Founding Lifetime purchase, limited to the first 500 licences — see pricing for the current prices in your region. Boogie Push is a separate, optional add-on for iPhone and iPad (see Notifications); it doesn't unlock the app on its own.

Family Sharing: Lifetime can be shared with your Family Sharing group. The annual subscription and Boogie Push are for the person who buys them.

Check your plan any time in Settings → Subscription. Already paid and setting up a new device? Use Restore Purchases there. You can manage or cancel a subscription from your App Store subscriptions.

Troubleshooting

Can't sign in

  • Confirm your server offers JMAP. Boogie is JMAP-only by design and does not fall back to IMAP.
  • Fastmail: choose Sign in with Fastmail and approve access on Fastmail's page. If you use an API token instead, paste it via Use a password or token instead — not into a password field. See Getting started.
  • Self-hosted: check that https://your-server/.well-known/jmap resolves, or choose Specify server manually.

Mail isn't syncing

  • Check the device can reach your server (VPN-only servers need the VPN up).
  • Pull to refresh, or quit and relaunch — Boogie reconnects and resumes on its own.
  • Still stuck? Reset Email Cache & Resync in Settings re-pulls everything from the server.

No notifications for a folder

Since 1.4 only the Inbox notifies you by default. Switch other folders on in Settings → Accounts → your account → Notifications. For notifications while Boogie is fully closed on iPhone or iPad, see Boogie Push under Notifications.

Calendar is empty

Your server must support JMAP calendars — see Calendar. On Fastmail, add the account with Sign in with Fastmail to be sure your calendars come across.

Apple Watch has no account

See Apple Watch: iCloud Keychain sync must be on, accounts that use your provider's sign-in page need a separate sign-in on the Watch, and Fastmail accounts added with Sign in with Fastmail can't be used on the Watch yet.

Restore Purchases isn't working

Make sure you're signed in with the same Apple Account you bought with, then try Restore Purchases again — in Settings → Subscription, or on the lock screen. You can check your plan in your App Store subscriptions.

Report a problem

Email support@boogie.digital with what you did, what you expected, what happened instead, your platform (Mac, iPhone, iPad, Watch) and OS version, and the Boogie version. Screenshots help. Boogie has no analytics — we genuinely can't see your problem unless you tell us.

Frequently asked questions

Which email servers does Boogie work with?

Boogie is a native JMAP 1.0 client. It works with any server that implements JMAP (RFC 8620) and, optionally, the JMAP Calendar specification (RFC 8621). Checked against Stalwart and Fastmail before every release. No IMAP, no Exchange — if your provider speaks JMAP, Boogie connects.

My server isn't auto-discovered. What now?

Boogie uses the .well-known/jmap convention (RFC 8620 §2.2). If your server doesn't publish one, switch to 'Manual' in the account setup sheet and paste the JMAP session URL directly. Your provider's documentation or admin can tell you the URL.

How do I restore a previous purchase on a new device?

Open Settings → Subscription → Restore Purchases. Must be signed into the same Apple ID that made the original purchase. Family Sharing works for the Lifetime tier only.

The trial expired. What happens?

Boogie locks until you subscribe (yearly) or buy lifetime. Your mail, calendars, and contacts are untouched and nothing is deleted — choose a plan and everything unlocks straight away. From the lock screen you can also restore a purchase, remove your account, or contact support.

Where is my mail stored?

On your device (in a local SQLite database) and on your chosen JMAP server. Boogie is a transport — we don't run servers, we don't store your mail, we don't see your mail. Full details: privacy policy.

How do I report a bug?

Email support@boogie.digital with: (1) Boogie version (Settings → About), (2) your device and OS version, (3) steps to reproduce, (4) anything in the logs that looked relevant (Settings → Logs → Export). We read every report.

Install Boogie

  • App Store — Available on the Mac App Store, App Store for iPhone and iPad, and watchOS.