
colliedesk
io.github.colliedesk/colliedesk
Work a Colliedesk helpdesk inbox: find, triage and answer customer conversations.
Documentation
Colliedesk
The open-source alternative to Freshdesk, Zendesk and Help Scout for small support teams. Leave Freshdesk with all your data. AI that actually answers tickets is included, not an add-on. Flat price, no per-agent fees.
Think of Colliedesk as the sheepdog for your support queue: the AI herds every ticket home, your team stays in charge.
Status: generally available (1.x). Upgrades keep your data, export always works, and what general availability guarantees covers backups, uptime and self-hosted installs. See the roadmap and versioning.
"Wait, what are you selling me?"
Self-hosting Colliedesk is free, forever, with every feature. We sell two things:
- Colliedesk Cloud: we run it for you. One flat price per workspace, not per agent. Every new workspace starts with a 14-day free trial, no card needed; there is no permanent free plan. When the trial ends the workspace is locked, never deleted, and you can always export all your data.
- Migration: we move your Freshdesk history (tickets, replies, attachments, tags) and give you a reconcile report that proves nothing was lost.
AI features work with your own model key on self-hosted installs (bring your own AI key). On the cloud you can bring your key or use ours at cost plus a small margin.
If you don't like something, fork it
You were held hostage at renewal once. That should not happen again. Colliedesk is AGPL-3.0: the code, your data and the export format are yours. If we ever go in the wrong direction, you have everything you need to run it yourself or fork it.
Install
Requirements: Docker with Compose v2.
curl -fsSL https://raw.githubusercontent.com/colliedesk/colliedesk/main/install.sh | sh -s -- \
--name "My Support Desk" --email "admin@example.com"
The installer starts Colliedesk and PostgreSQL, keeps your secrets in a local .env, and prints a
one-time sign-in URL. Colliedesk does not use passwords. Details: docs/self-host.
What works today
- Passwordless sign-in with one-time pairing and invite links, optional cloud sign-in, and revocable sessions.
- Shared inbox: reply, private notes, status, assignee, tags, search, pagination.
- Workspaces fully isolated from each other.
- Per-workspace timezone with per-agent override.
User guides: docs/user. Running your own server: docs/self-host. Both are also published at colliedesk.com/docs by colliedesk/colliedesk.com.
Development
make dev runs the server and web app. make test needs PostgreSQL at the default test URL or
TEST_DATABASE_URL. Read AGENTS.md before changing code, whether you are a person
or a coding agent.
Versioning
Colliedesk uses Semantic Versioning from 1.0.0: a breaking change to the
API, the CLI or the export format needs a new major version; new features raise the minor version,
fixes the patch version. Every schema change ships as a migration that upgrades your data in
place. The 0.0.x releases before 1.0.0 were early releases. Merging to main does not make a release: HC Labs cuts one by hand,
from the build that already runs on Colliedesk Cloud. Changes per release are on the
releases page.
Container image tags:
latest: the newest release. The installer uses it by default.1.2.3: one exact release, if you want to pin.1.2: the newest patch release of that minor version.edge: the newestmaincommit that passed CI. Newer, less tested.
License
Copyright (C) 2026 HC Labs. Colliedesk is licensed under the GNU Affero General Public License
v3.0 only (AGPL-3.0-only). See LICENSE. Contributions require the HC Labs CLA
(see CONTRIBUTING.md).
No installation packages available.