Skip to Content
Docs

Introduction

Helpwren is open-source, self-hosted live chat, tickets and a help center that plug into any product.

Each product runs its own install, on its own address and in its own Supabase database. There is no per-seat pricing, and the code is MIT licensed.

Where to start

These docs follow how far you take Helpwren. Most sites stop after the first two steps; each later one is optional.

StepWhat you get
Get startedAn install of your own, a first admin and a working chat
Add the chatThe chat on your site from one script tag, styled and placed as you want
Know your usersLogged-in users recognised, with their history on every device
Help centerArticles that rank in search engines and show in the chat
Mobile and pushThe chat as a screen of your React Native or Expo app, with push
EmailNotifications by email, and replies by email back into the chat

The rest is for running it: the inbox for your team, security and abuse protection, and operations: upgrades, backups, scheduled jobs and the health check.

What it does

  • Live chat for visitors and logged-in users, with attachments, typing indicators, online status and a rating at the end of a conversation.
  • Tickets: a conversation with a number, status, priority and assignee, plus internal notes only the team can see.
  • An inbox for the team, with views, search, contacts, saved replies and live visitors.
  • A help center with collections, articles and search, built to rank in search engines and embeddable in your own site. Featured articles show on the chat's home screen.
  • A widget loaded by one snippet, or the helpwren package for an app that bundles its own code.
  • A mobile screen for React Native and Expo apps, with an unread badge and push through Expo, Firebase or a webhook to your own backend.
  • Email through SMTP or Resend, and replies by email that land in the same conversation.
  • Your brand: name, logo and colour, in light and dark.

What it does not do

Helpwren is deliberately small. It has no AI answers, chatbot builder, phone or social channels, or hosted version. You run it yourself, on Supabase Cloud with Vercel or on your own server with Docker. How it fits together shows the pieces, and Concepts the words the rest of these docs use.