# godaddy/terminus

Graceful shutdown and Kubernetes readiness / liveness checks for any Node.js HTTP applications

Repository: https://github.com/godaddy/terminus
Canonical: https://ross.abutalabs.com/products/terminus
Language: JavaScript
License: MIT
License Family: permissive
Topics: nodejs, kubernetes, graceful-shutdown, hacktoberfest
Last push: 2025-08-20T16:59:16+00:00

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

## Adoption (not part of the score)
Stars 1911, forks 94 (observed 2026-08-28T04:05:53.265891+00:00)

## What it is
Terminus is a Node.js library that adds graceful shutdown and Kubernetes readiness/liveness health check endpoints to any HTTP server. It hooks into shutdown signals to run cleanup logic and serves configurable health check routes.

## Use cases
- add kubernetes readiness and liveness probes to a node.js app
- gracefully shut down an http server on SIGTERM
- run cleanup logic like closing database connections before shutdown
- expose a /healthcheck endpoint for container orchestration
- avoid dropped requests during rolling deployments

## When to choose
- you run Node.js HTTP services on Kubernetes or other orchestrators
- you need zero-downtime deployments with graceful connection draining
- you want standardized health endpoints without a full framework

## When to avoid
- your app is not an HTTP server
- you need health checks for non-Node.js runtimes
- you want a full service mesh or orchestrator-level solution

## Facets
- artifact type: library
- maturity: active
- function: http-server, middleware, monitoring
- domain: backend, web-development
- platform: -
- tags: graceful-shutdown, health-checks, kubernetes-readiness, liveness-probes, sigterm-handling, devops, containers, nodejs, kubernetes, docker

## Member repositories
- godaddy/terminus (main) score 39

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:53.265891+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-30T03:10:47.303048+00:00, confidence not recorded.
  - readme: https://github.com/godaddy/terminus (fetched 2026-08-28T04:05:53.265891+00:00, sha af45b44b869e)
- Data as of 2026-08-30T08:39:29.467469+00:00.