💡 Why Kontext?

Google Workspace and Microsoft 365 are convenient, but every user costs money every month and the
data sits with a US corporation. Kontext is just as convenient in the browser and on the phone, but
runs on your server: a small VPS from about €5 a month (e.g. at IONOS or Hetzner) or a machine
of your own.

• Made in Europe, for Europe: developed in Europe, open source, on your server. No US
  provider in between, so no access to your data under the US CLOUD Act.
• Your data stays with you (GDPR): mails, appointments, contacts, chat and calls live on your
  server, in Europe or in your own office. No US provider, no trackers.
• No per-seat pricing: ten people cost the same as one; you pay for the server.
• Everything about a customer in one place: their latest mails, next appointments, open tasks
  and calls – a small CRM without another tool.
• One app instead of five: mail, calendar, tasks, team chat with video calls, the office phone
  and documents, with one sign-in.
• Built for the phone too: every view works on the phone, swipe a mail to archive it, and it
  installs as an app without an app store.
• Accessible by keyboard: every view works without a mouse, with visible focus and a skip
  link, in light and dark – more on accessibility.
• AI if you want it: Claude and other assistants find customers, mails and appointments for you
  and write drafts – they never send or delete anything.
• Open, no lock-in: open source (AGPL) and standard protocols, so Outlook, Thunderbird, iPhone
  and Android keep working and you can take everything with you.

Who it's for: freelancers · trades · law firms and medical practices · small and mid-sized
businesses · self-hosters looking for a web client for Stalwart.

🚀 Install

1. Let an agent set it up

Give Claude Code or another coding agent this repository and SSH access to your server and say:
"Set up Kontext on my server following the installation guide."

2. Manually

On a server with Docker (or Podman), your own domain and open ports 25, 80, 443, 465, 587 and 993:

# The configuration (compose.yaml, .env.example, Caddyfile, backups); the programs come from Docker Hub
git clone https://github.com/firsttris/kontext /opt/kontext && cd /opt/kontext
cp deploy/.env.example deploy/.env && chmod 600 deploy/.env
nano deploy/.env                              # domain, version, backup target, replace every change-me
docker compose -f deploy/compose.yaml up -d   # pulls Kontext, Stalwart and Caddy and starts them (or Podman)

Then the main steps in Stalwart's admin (port 8080, only through an SSH tunnel or Tailscale); the
guide lists all of them:

1. Set up the domain and DKIM and create the boss's account; the boss adds everyone else in Kontext.
2. Enter Kontext's network 10.89.250.0/24 as an allowed IP, so that wrong passwords never get
   Kontext itself banned.
3. Create the API key for the company admin, put it into deploy/.env as STALWART_ADMIN_KEY and
   start Kontext again (how).
4. Register Kontext as the first-party OAuth client kontext (redirect URI
   https://kontext.invalid/oauth) and allow directory queries (Sharing); Stalwart 1.0 signs in
   only clients it knows and hides the colleagues otherwise.
5. Sign in at https://<your domain>.

Calls and documents (Schreibzeug, no install of its own needed) are switched on in .env.example; to leave them out, remove them from
COMPOSE_PROFILES. Telephony adds a small box in the office. Ten users run fine on a VPS with
2 vCPUs and 4 GB RAM. Everything else – DNS, Podman, backups, updates – is in the
installation guide (German).

✨ Features

📸 Screenshots

Shared mailbox – info@ for the whole team · docs →	Writing – rich text, quote, sender · docs →
Calendar – week, month, availability · docs →	Contacts – the customer at a glance · docs →
Tasks – a Kanban board per mailbox · docs →	Team chat – mails as cards, tasks from messages · docs →

🔀 Kontext and the alternatives

Kontext is made for a small business that wants Google Workspace comfort on its own server, with
mail, calendar, chat and the office phone in one place.

❓ FAQ

Yes, Kontext: mail with shared mailboxes, calendar, contacts, tasks, team chat with video calls and
the office phone in one web app on your own server, with documents through
Schreibzeug. See the installation guide.

The software is free (AGPL). You need a server – a VPS from about €5 a month – and someone who
sets it up and keeps it updated.

Yes, that is what Kontext is: a JMAP web client for mail, calendar and contacts on
Stalwart, plus tasks, chat, telephony and a company admin area that manages
Stalwart's accounts and groups. See the architecture.

Yes. A telephone box in the office registers as an IP phone at the Fritzbox; calls then ring in
Kontext with the caller's contact, last mail and next appointment, and you call out from any
contact. See Telephony.

Yes, Kontext runs wherever Docker or Podman runs. To receive mail from the internet the machine
needs port 25 reachable from outside, a fixed IP address and a reverse DNS entry; home internet
connections usually block port 25. At home it works best with a mail relay in front – a small VPS
is simpler. The telephone box runs on a NAS, a Raspberry Pi or a thin client in the office.

It is built for it: the data stays on your server, without trackers or third parties. You sign a
data processing agreement with your hosting provider; with a server in your own building not even
that.

No, Kontext is no mail archive. The German retention rules (GoBD) ask that business mail is kept
for years so that nobody can delete or change it; in Kontext people can delete their mail. For that
a GoBD archive belongs beside it. Kontext gives the pieces around it: nothing is deleted when
someone leaves, and backups go encrypted and unalterable (Object Lock) to S3 storage.

Yes. Stalwart speaks IMAP, SMTP, CalDAV and CardDAV; every mail program and phone can connect
directly. Kontext is the browser interface on top, and its tasks are CalDAV task lists too.

Yes, under Settings → Company → Migration: IMAP mailboxes (kept in sync until the move is finished),
Microsoft 365 through an app in the company's Microsoft account, Outlook as a PST file, contacts and
calendars from a Google export. See Company admin and moving in.

Yes, under Einstellungen → Weitere Postfächer (Settings → Other mailboxes): new mail comes into Kontext, and you send as that address
through the provider's server, so recipients see it as genuine.

Yes. Kontext is an MCP server, so Claude and other agents can look things up with your rights,
write drafts and invite colleagues to appointments; they never mail anyone outside or delete anything. See AI agents.

German and English, per device under Settings → Appearance → Language (otherwise the browser's language). Other European languages are planned.

Check it yourself, the code is open: let your agent run Cloudflare's Security Audit Skill or
Claude Code's /security-review on this repository.
Report vulnerabilities privately as described in SECURITY.md.

📚 Documentation

The documentation opens with a tour in pictures, made to send to customers: in English and in German.

The full documentation (German), with search, is at firsttris.github.io/kontext:
every feature in detail, installation,
architecture and
development. What changed in each release,
with the steps an update needs, is in the changelog; what comes next is in the
roadmap (German).

🛠️ Development

Needs Bun 1.4 and Linux or macOS (Windows through WSL).

git clone https://github.com/firsttris/kontext && cd kontext
bun install
bun run dev   # Stalwart with test data, server and app: http://localhost:5173

Sign in as [email protected] / kaffee-werkbank-kontext (the boss, sees the company
admin too); anna@, sandra@ and max@ share the password, info@ and rechnung@ are shared
mailboxes. bun run dev:stalwart -- --fresh --seed resets the test data.

React, TanStack Router/Query, Tailwind and Tiptap in the browser; a small Bun server with Hono,
Better Auth and SQLite (Drizzle) for sign-in, JMAP to Stalwart, chat and tasks; LiveKit for calls,
Asterisk in the telephone box. Tests, CI and releases: Development.

🧩 More from us

• Word, Excel and PowerPoint without Microsoft 365? Schreibzeug edits them in the browser and keeps them as .docx, .xlsx and .pptx.
• Doing your own books in Germany? Haben: invoices with e-invoicing, receipts, bank reconciliation and VAT returns via ELSTER.

🤝 Contributing

Issues and pull requests are welcome. A good bug report names the browser or phone, the view,
what happened and the Kontext version (a screenshot helps); the
bug report form asks for
all of it. Security problems please report privately, see SECURITY.md. Before a pull
request please run the checks from CONTRIBUTING.md:

bun run typecheck && bun run lint && bun run test && bun run build   # or: bun run check
bun run e2e                                                          # Playwright against its own Stalwart
mkdocs build --strict                                                # when docs/ changed