libredesk/README.md at c8463d18e33fa97282dbee2d2a35d374a8ca148e

mirror of https://github.com/abhinavxd/libredesk.git synced 2026-10-26 06:19:36 +00:00

Files

T

Abhinav Raut 0c1dec7456 simplify inbox aliases and tidy the email inbox form

Drop the check that blocked one address on two inboxes and simplify sender
lookup, alias verification and IMAP handling. The inbox form now shows the
connected account first, lines up its fields and shows one hint for unsaved aliases.

2026-09-27 22:54:40 +05:30

4.7 KiB

Raw Blame History

Open source, self-hosted customer support software for email, live chat, and WhatsApp. Distributed as a single binary.

Visit libredesk.io for more info. Check out the live demo.

Features

Inbox and channels

Shared inbox: Handle email, live chat, and WhatsApp conversations in one place.
Live chat: Add a real-time chat widget to your website.
WhatsApp: Connect a number through the Meta Cloud API.
Inbox organization: Use teams, tags, custom statuses, custom attributes, snoozing, and search.

Help center and AI

Help center: Publish a searchable, multilingual knowledge base.
AI assistant: Answer live chat questions using your knowledge base and hand conversations to an agent when needed.
Agent copilot: Draft replies, summarize conversations, and find answers without leaving the inbox.

Workflow and reporting

Automations: Tag, assign, and route conversations using rules you define.
Macros: Send saved replies and apply conversation actions in one step.
Auto assignment: Distribute incoming conversations by agent capacity or your own criteria.
SLA management: Set response targets and get notified about conversations at risk of breaching them.
CSAT and analytics: Collect customer ratings and track response times, resolution rates, and agent activity.

Administration and integrations

Permissions and SSO: Create roles with per-action permissions and sign in through Google, Microsoft, or another OIDC provider.
Activity logs: Review actions performed by agents and admins.
API and webhooks: Connect LibreDesk to other systems and workflows.

See libredesk.io for the full feature set, or try the live demo.

Installation

Railway (1-click deploy)

The fastest way to get a libredesk instance running. Railway provisions the app, Postgres, and Redis for you.

Docker

The latest image is available on DockerHub at libredesk/libredesk:latest

# Download the compose file and sample config file in the current directory.
curl -LO https://github.com/abhinavxd/libredesk/raw/main/docker-compose.yml
curl -LO https://github.com/abhinavxd/libredesk/raw/main/config.sample.toml

# Copy the config.sample.toml to config.toml and edit it as needed.
cp config.sample.toml config.toml

# Run the services in the background.
docker compose up -d

# Setting System user password.
docker exec -it libredesk_app ./libredesk --set-system-user-password

Go to http://localhost:9000 and login with username System and the password you set using the --set-system-user-password command.

See installation docs

Binary

Download the latest release and extract the libredesk binary.
Edit config.toml as needed.
./libredesk --install to setup the Postgres DB.
Run ./libredesk --set-system-user-password to set the password for the System user.
Run ./libredesk and visit http://localhost:9000 and login with email System and the password you set using the --set-system-user-password command.