# HumHub — Open-Source Enterprise Social Network

> A flexible, open-source social networking platform built on Yii2 for creating private communities, intranets, and collaboration spaces within organizations.

## Install

Save in your project root:

# HumHub — Open-Source Enterprise Social Network

## Quick Use
```bash
git clone https://github.com/humhub/humhub.git
cd humhub
composer install
# Open in browser and follow the web-based setup wizard
```

## Introduction
HumHub is an open-source social networking platform designed for organizations that want to run their own private community or intranet. Built on the Yii2 PHP framework, it provides a familiar social-media-like experience with activity streams, spaces, messaging, and a module marketplace for extending functionality.

## What HumHub Does
- Creates a private social network with user profiles, activity streams, and notifications
- Organizes content into Spaces (groups) with separate membership and permissions
- Provides direct messaging, file sharing, and collaborative content creation
- Supports a marketplace of modules for calendars, wikis, tasks, and polls
- Enables SSO integration with LDAP, SAML, and OAuth providers

## Architecture Overview
HumHub is built on the Yii2 PHP framework using an MVC architecture. User content is stored in MySQL or MariaDB. The module system allows installing marketplace modules or building custom ones that hook into the core via events and widgets. The frontend uses a responsive Bootstrap-based theme with JavaScript enhancements. Real-time updates use long-polling or WebSocket via an optional push server.

## Self-Hosting & Configuration
- Requires PHP 8.0+, MySQL 5.7+ or MariaDB, and Apache or Nginx
- Install via Composer or download the release archive
- Run the web-based setup wizard to configure database and admin account
- Configure LDAP or SAML for enterprise single sign-on
- Use the admin panel to manage modules, themes, and user registration settings

## Key Features
- Space-based organization with granular membership and permission controls
- Activity stream with posts, comments, likes, and mentions
- Module marketplace for calendars, wikis, tasks, polls, and galleries
- REST API for building integrations and custom frontends
- Theming system with customizable layouts and branding

## Comparison with Similar Tools
- **Discourse** — Forum-first design; better for public communities, less intranet-focused
- **Rocket.Chat** — Messaging-first; better for real-time chat, less social networking
- **Mastodon** — Federated public microblogging; not designed for private organizations
- **Nextcloud** — File-sharing focus with social features; different primary purpose
- **Workplace (Meta)** — SaaS corporate social; closed-source with per-user pricing

## FAQ
**Q: Is HumHub free?**
A: The Community Edition is free and open-source. A Professional Edition adds premium modules and priority support.

**Q: Can I use HumHub as a company intranet?**
A: Yes. HumHub is commonly deployed as a private intranet with LDAP integration, department spaces, and internal communication tools.

**Q: Does HumHub support single sign-on?**
A: Yes. LDAP, SAML, and OAuth authentication modules are available for enterprise SSO setups.

**Q: How extensible is HumHub?**
A: The module system supports custom development. You can create modules that add content types, widgets, pages, and API endpoints following Yii2 conventions.

## Sources
- https://github.com/humhub/humhub
- https://docs.humhub.org

---
Source: https://tokrepo.com/en/workflows/2fb04c5b-4237-11f1-9bc6-00163e2b0d79
Author: AI Open Source