This is the documentation for the old GraphQL Yoga version 4. We recommend upgrading to the latest GraphQL Yoga version 5.

Migrate to GraphQL Yoga v5

Integration with Hapi

Hapi allows you to build powerful, scalable applications, with minimal overhead and full out-of-the-box functionality - your code, your way.

It continues to be the proven choice for enterprise-grade backend needs.


npm i @hapi/hapi graphql-yoga graphql


import http from 'node:http'
import { Readable } from 'node:stream'
import { createSchema, createYoga } from 'graphql-yoga'
import Hapi from '@hapi/hapi'
import { schema } from './my-graphql-schema'
interface ServerContext {
  req: Hapi.Request
  h: Hapi.ResponseToolkit
const yoga = createYoga<ServerContext>({ schema })
const server = Hapi.server({ port: 4000 })
  method: '*',
  path: yoga.graphqlEndpoint,
  options: {
    payload: {
      // let yoga handle the parsing
      output: 'stream'
  handler: async (req, h) => {
    const { status, headers, body } = await yoga.handleNodeRequest(req.raw.req, { req, h })
    const res = h.response(
      Readable.from(body, {
        // hapi needs the stream not to be in object mode
        objectMode: false
    for (const [key, val] of headers) {
      res.header(key, val)
    return res.code(status)

The GraphQL Yoga server should now be available at http://localhost:4000/graphql.

You can also check a full example on our GitHub repository here.