# facebookarchive/grace

Graceful restart & zero downtime deploy for Go servers.

Repository: https://github.com/facebookarchive/grace
Canonical: https://ross.abutalabs.com/products/grace
Homepage: https://godoc.org/github.com/facebookgo/grace
Language: Go
License: MIT
License Family: permissive
Archived: true
Last push: 2019-02-13T01:07:15+00:00

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

## Adoption (not part of the score)
Stars 4881, forks 419 (observed 2026-08-28T04:09:01.810733+00:00)

## What it is
A Go library for building socket-based servers that support graceful termination and restart without dropping connections. It provides APIs for HTTP servers (including TLS and multiple listeners) and is compatible with systemd socket activation.

## Use cases
- zero downtime deploys for go http servers
- graceful restart without dropping connections
- hot reload a go server on signal
- serve in-flight requests before shutdown
- systemd socket activation for go services
- gracefully restart server listening on multiple ports

## When to choose
- you need zero-downtime restarts for a Go HTTP or socket server
- you want in-flight requests to complete during a restart
- you need systemd socket activation compatibility

## When to avoid
- you need an actively maintained library - the repo is archived
- you deploy behind a load balancer or reverse proxy that can drain connections for you
- you use a modern framework with built-in graceful shutdown

## Facets
- artifact type: library
- maturity: abandoned
- function: http-server, concurrency, deployment
- domain: backend, web-development, developer-tools
- platform: go, cross-platform
- tags: graceful-restart, zero-downtime, socket-activation, hot-reload, systemd, linux

## Member repositories
- facebookarchive/grace (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:01.810733+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-29T18:18:16.220983+00:00, confidence not recorded.
  - readme: https://github.com/facebookarchive/grace (fetched 2026-08-28T04:09:01.810733+00:00, sha daea3be9c069)
  - homepage: https://godoc.org/github.com/facebookgo/grace (fetched 2026-08-29T09:00:40.054790+00:00, sha edfac92b2d20)
  - site_page: https://pkg.go.dev/about (fetched 2026-08-29T09:00:40.065662+00:00, sha 757852027879)
  - site_page: https://pkg.go.dev/github.com/facebookgo/grace (fetched 2026-08-29T09:00:40.063842+00:00, sha f8b17f56d7f9)
  - site_page: https://go.dev/project (fetched 2026-08-29T09:00:40.067456+00:00, sha d5ca00bb378b)
- Data as of 2026-08-30T08:39:29.467469+00:00.