# bitwalker/libcluster

Automatic cluster formation/healing for Elixir applications

Repository: https://github.com/bitwalker/libcluster
Canonical: https://ross.abutalabs.com/products/libcluster
Language: Elixir
License: MIT
License Family: permissive
Topics: clustering, erlang-distribution, elixir
Last push: 2025-01-09T09:28:41+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3624, "days_push": 601, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2155, forks 200 (observed 2026-08-28T04:06:19.626922+00:00)

## What it is
An Elixir library that automatically forms and heals clusters of Erlang nodes using pluggable strategies such as EPMD, multicast UDP gossip, Kubernetes metadata/DNS, and Rancher. It supports static or dynamic node membership and custom clustering strategies.

## Use cases
- automatically connect Elixir nodes into a cluster
- form a Phoenix cluster on Kubernetes
- heal an Erlang distribution cluster after node failures
- discover nodes via multicast gossip
- set up static clustering of Erlang nodes
- implement a custom clustering strategy for my environment

## When to choose
- you run Elixir/Erlang apps that need multi-node clustering
- you deploy on Kubernetes and want automatic node discovery
- you want pluggable, configurable clustering topologies

## When to avoid
- you run a single-node application
- you need clustering for non-BEAM languages
- you need service discovery outside the Erlang distribution model

## Facets
- artifact type: library
- maturity: stable
- function: microservices, service-discovery, networking, concurrency
- domain: microservices, backend
- platform: elixir, jvm, self-hosted
- tags: clustering, erlang-distribution, elixir, kubernetes, node-discovery, distributed-erlang, devops, linux, docker

## Member repositories
- bitwalker/libcluster (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:19.626922+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:50:36.349560+00:00, confidence not recorded.
  - readme: https://github.com/bitwalker/libcluster (fetched 2026-08-28T04:06:19.626922+00:00, sha 5fce353c91ed)
- Data as of 2026-08-30T08:39:29.467469+00:00.