Koa middleware mounting the GET /health route returning the app status depending on ctx.isShutdown existence.

Usage no npm install needed!

<script type="module">
  import sigfoxKoaHealthCheck from 'https://cdn.skypack.dev/@sigfox/koa-health-check';



Koa middleware mounting the route GET /health.

When use it?

You can use this module if you need a route returning the health status of your Koa app.


Mount GET /health to your Koa app, this route verifies the existence of a field in the Koa's context, and will set the status to 503 if that field exists, otherwise 200.


npm install @sigfox/koa-health-check


  • fieldToVerify (String) (default: "isShutdown"): The name of the field in the ctx that /health will search for, if that field exists and is truthy, a 503 status will be responded.
const Koa = require('koa');
const healthCheck = require('@sigfox/koa-health-check');

const HEALTH_CHECK_DELAY = 2000;

const app = new Koa().use(healthCheck());

const server = app.listen();

process.on('SIGTERM', () => {
  app.context.isShutdown = true;
  console.warn(`Received SIGTERM signal, respecting health check delay ${HEALTH_CHECK_DELAY}ms...`);
  setTimeout(() => server.close(), HEALTH_CHECK_DELAY);


npm test


This project is licensed under the MIT License - see the LICENSE file for details.