Repolode
Submit
hcengineering

hcengineering/huly-selfhost

Docker Compose and Kubernetes deployment setup for self-hosting Huly, an open-source all-in-one team collaboration platform.

Open-source alternative to:SlackLinearJira

View on GitHub
Stars
3,576
Forks
470
Open issues
138
Last commit
22 days ago

What is it?

This repository provides the deployment configuration for running Huly, a team collaboration platform, on your own server. It includes a Docker Compose setup with an nginx reverse proxy, a setup script that generates the configuration, and a sample Kubernetes configuration under the kube directory. The platform source code lives in a separate repository.

The stack runs several services, including CockroachDB for storage, Redpanda for messaging, and Elasticsearch for search. Optional components can be enabled for email (SMTP or Amazon SES), audio and video calls via LiveKit, web push notifications, Gmail and Google Calendar integration, GitHub and Telegram integrations, OpenID Connect and GitHub sign-in, and an AI chatbot backed by OpenAI. Persistent data can use Docker named volumes or custom host paths.

The documentation recommends at least 2 vCPUs and 8 GB RAM, with 4 vCPUs and 16 GB or more preferred. Upgrades are managed by changing the Huly version tag in the environment file, and a MIGRATION.md file lists version-specific steps.

Key features

  • 01Docker Compose stack with an nginx reverse proxy and a setup script that generates config
  • 02Optional Kubernetes sample configuration
  • 03Email notifications through SMTP or Amazon SES
  • 04Audio and video calls built on LiveKit
  • 05GitHub bi-directional sync for issues and pull requests, plus Google Calendar and Telegram integrations
  • 06Sign-in via OpenID Connect or GitHub OAuth, with sign-up can be disabled

Use cases

  • Hosting a private team workspace for chat, issues and documents on your own Linux server
  • Evaluating Huly locally with the quick-start script before a production rollout
  • Connecting an existing OIDC identity provider to control who can sign in

Quick start

  1. 1

    Clone the huly-selfhost repository

    git clone https://github.com/hcengineering/huly-selfhost.git
  2. 2

    Enter the project folder

    cd huly-selfhost
  3. 3

    Run the quick local setup script

    ./setup.sh --quick
  4. 4

    Open Huly in your browser at localhost:8087 after about 60 seconds

Things to know

  • Requires a server with at least 2 vCPUs and 8 GB RAM, and 4 vCPUs and 16 GB RAM recommended.
  • The bundled CockroachDB and Redpanda configurations may not be production-ready.
  • The quick start mode is intended for local testing only.

Topics

#self-hosted#docker-compose#kubernetes#collaboration#nginx#team-chat#project-management

FAQ

What is huly-selfhost?
Docker Compose and Kubernetes deployment setup for self-hosting Huly, an open-source all-in-one team collaboration platform. This repository provides the deployment configuration for running Huly, a team collaboration platform, on your own server. It includes a Docker Compose setup with an nginx reverse proxy, a setup script that generates the configuration, and a sample Kubernetes configuration under the kube directory. The platform source code lives in a separate repository.
Is huly-selfhost free to use? What license does it have?
huly-selfhost is open source under the EPL-2.0 license. Check the license terms before using it in commercial products.
Is huly-selfhost still maintained?
Actively maintained. The last commit to huly-selfhost was on Sep 29, 2026.
What can I use huly-selfhost for?
Hosting a private team workspace for chat, issues and documents on your own Linux server Evaluating Huly locally with the quick-start script before a production rollout Connecting an existing OIDC identity provider to control who can sign in
How do I install huly-selfhost?
Clone the huly-selfhost repository: git clone https://github.com/hcengineering/huly-selfhost.git Enter the project folder: cd huly-selfhost Run the quick local setup script: ./setup.sh --quick Open Huly in your browser at localhost:8087 after about 60 seconds
Where can I get huly-selfhost?
The source code and installation instructions are on GitHub: https://github.com/hcengineering/huly-selfhost

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects