# Huly — All-in-One Open Source Project Management Platform

> Huly is an open-source alternative to Linear, Jira, Slack, and Notion. Project tracking, team chat, knowledge base, and HR tools in a single unified platform.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
git clone https://github.com/hcengineering/platform.git
cd platform
docker compose up -d
```

Open `http://localhost:8083` — create your workspace and invite your team.

## Intro

**Huly** is an open-source, all-in-one project management platform that combines issue tracking, team chat, document collaboration, and HR management into a single product. Built as an alternative to Linear + Slack + Notion + Motion, it provides a unified workspace where teams can plan, communicate, and document — without switching between multiple tools.

With 25.3K+ GitHub stars and EPL-2.0 license, Huly has gained rapid adoption from teams tired of context-switching between Linear for tasks, Slack for chat, Notion for docs, and Jira for project management.

## What Huly Does

Huly unifies multiple workflow tools:

- **Issue Tracking**: Linear-style issue management with projects, sprints, priorities, and kanban boards
- **Team Chat**: Real-time messaging with channels, threads, reactions, and file sharing
- **Documents**: Collaborative wiki/knowledge base with rich editor and nested pages
- **Time Tracking**: Built-in time tracking for issues and projects
- **HR Module**: Employee profiles, department management, leave requests, and onboarding
- **CRM**: Contact management and deal pipeline (in development)
- **Notifications**: Unified notification center across all modules

## Architecture

Huly uses a unique reactive architecture:

```
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Svelte      │────▶│  Platform    │────▶│  MongoDB     │
│  Frontend    │     │  Server      │     │  (Data)      │
└──────────────┘     │  (TypeScript)│     └──────────────┘
                     └──────┬───────┘
                            │
                  ┌─────────┼─────────┐
                  │         │         │
           ┌──────┴──┐ ┌───┴───┐ ┌───┴────┐
           │ Elastic  │ │ MinIO │ │ Love   │
           │ Search   │ │(Files)│ │(Collab) │
           └──────────┘ └───────┘ └────────┘
```

## Self-Hosting

### Docker Compose

```yaml
services:
  huly:
    image: hardcoreeng/huly:latest
    ports:
      - "8083:8083"
    environment:
      SERVER_SECRET: your-secret-key
      MONGO_URL: mongodb://mongo:27017
      ELASTIC_URL: http://elastic:9200
      MINIO_ENDPOINT: minio
      MINIO_ACCESS_KEY: minioadmin
      MINIO_SECRET_KEY: minioadmin
    depends_on:
      - mongo
      - elastic
      - minio

  mongo:
    image: mongo:7
    volumes:
      - mongo-data:/data/db

  elastic:
    image: elasticsearch:7.17.22
    environment:
      - discovery.type=single-node
      - xpack.security.enabled=false
    volumes:
      - elastic-data:/usr/share/elasticsearch/data

  minio:
    image: minio/minio
    command: server /data
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin
    volumes:
      - minio-data:/data

volumes:
  mongo-data:
  elastic-data:
  minio-data:
```

## Key Features

### Linear-Style Issue Tracking

- **Projects**: Organize work into projects with custom workflows
- **Sprints**: Time-boxed iterations with velocity tracking
- **Sub-issues**: Break down work with parent-child relationships
- **Labels & Priorities**: Categorize and prioritize with P0-P3 levels
- **Automations**: Auto-assign, auto-label, and status transitions based on rules
- **GitHub Integration**: Sync issues with GitHub PRs and commits

### Integrated Chat

Unlike standalone chat tools, Huly's chat is deeply integrated:
- Reference issues, documents, and team members inline
- Create issues directly from chat messages
- Thread discussions on any topic
- Channel-based organization (public, private, DM)

### Knowledge Base

- Nested document structure like Notion
- Real-time collaborative editing
- Markdown + rich content blocks
- Link between docs and issues

## Huly vs Alternatives

| Feature | Huly | Linear | Jira | Notion |
|---------|------|--------|------|--------|
| Open Source | Yes (EPL-2.0) | No | No | No |
| Issue tracking | Yes | Yes | Yes | Limited |
| Team chat | Built-in | No | No | No |
| Wiki/Docs | Built-in | No | Confluence | Yes |
| Time tracking | Built-in | No | Plugin | No |
| HR module | Built-in | No | No | No |
| Self-hosted | Yes | No | Data Center | No |

## FAQ

**Q: Can Huly really replace Linear + Slack + Notion?**
A: For small-to-mid teams, Huly's integrated experience really can replace all three. Larger teams may find each module less deep than the dedicated tools, but the integration benefits (no context switching, natively linked data) often make up for it.

**Q: GitHub/GitLab integration?**
A: GitHub integration is supported — link PRs and commits to Huly issues. GitLab integration is in community development.

**Q: Is self-hosting resource-hungry?**
A: It requires MongoDB + Elasticsearch + MinIO, with a minimum of 8GB RAM. That's more than a single tool, but reasonable given it replaces multiple tools.

## Source & Thanks

- GitHub: [hcengineering/platform](https://github.com/hcengineering/platform) — 25.3K+ ⭐ | EPL-2.0
- Website: [huly.io](https://huly.io)

---
Source: https://tokrepo.com/en/workflows/huly-all-one-open-source-project-management-platform-f3eabee0
Author: AI Open Source