Kurir / FAQ

Frequently Asked Questions

Is Kurir free?

Yes. Kurir is open source and released under the O’Saasy license. You can use it, modify it, and self-host it at no cost. The only expense is your own server.

Which email providers are supported?

Any provider that supports IMAP and SMTP. This includes Gmail, Outlook / Microsoft 365, iCloud, Yahoo, Fastmail, Proton Mail (with the Bridge app), and any custom mail server. See Email Accounts for the full list with connection details.

Can multiple people use one installation?

Yes. Kurir is multi-user. Each user has their own email account, their own Screener decisions, and their own categorized views (Imbox, Feed, Paper Trail). All data is isolated per user via userId filters in every database query.

Add users via the CLI:

pnpm add-user

Or through the web UI in Settings.

Where does my email data live?

All email data is stored in your PostgreSQL database on your server. Kurir does not send your emails or metadata to any third-party service. Your credentials are encrypted with AES-256-GCM before storage using the ENCRYPTION_KEY you set during installation.

Does Kurir delete emails from my provider?

No. Kurir never deletes your mail. Your emails stay with your provider regardless of what you do in Kurir.

Kurir does write a few things back over IMAP, so your other mail apps see the same state:

Can I use Kurir on my phone?

Yes. Kurir is a web application that works in any modern browser on any device. You can install it as a Progressive Web App (PWA) on iOS and Android for free, with push notifications. There are also native iPhone and Mac apps, paid, on the App Store. See Mobile & Mac Apps for both.

How is Kurir different from other email clients?

Kurir takes a different approach to email — the Screener, the Imbox, the Feed, and the Paper Trail. The key differences:

What happens if I stop using Kurir?

Nothing. Your emails stay with your email provider exactly as they were. Kurir does not move or delete emails from your provider’s servers. You can stop running Kurir at any time and continue using your email account with any other client.

Your Kurir-specific data (Screener decisions, categories, read state) lives in your PostgreSQL database. You can back it up, export it, or simply shut down the server.

What tech stack does Kurir use?

What are the server requirements?

Kurir runs comfortably on a small VPS:

Can I contribute?

Yes. Kurir is open source on GitHub. Issues, bug reports, and pull requests are welcome.