Client & CLI Configuration

By default, the Hive CLI and Hive Client SDK connect to the Hive Cloud version. In order to connect to a local Hive Server, you need to configure both the client and SDK.

Configuring the Client

Instantiate your Hive client with the selfHosting option.

custom.ts

import { createHive } from '@graphql-hive/core'
 
const hive = createHive({
  enabled: true,
  debug: true,
  token,
  selfHosting: {
    graphqlEndpoint: 'http://localhost:8082/graphql',
    usageEndpoint: 'http://localhost:8081',
    applicationUrl: 'http://localhost:8080/'
  },
  usage: true
})

graphql-yoga.ts

import { createYoga } from 'graphql-yoga'
import { useHive } from '@graphql-hive/yoga'
 
const yoga = createYoga({
  plugins: [
    useHive({
      enabled: true,
      debug: true,
      token,
      selfHosting: {
        graphqlEndpoint: 'http://localhost:8082/graphql',
        usageEndpoint: 'http://localhost:8081',
        applicationUrl: 'http://localhost:8080/'
      },
      usage: true
    })
  ]
})

apollo-server.ts

import { createYoga } from '@apollo/server'
import { useHive } from '@graphql-hive/apollo'
 
const apollo = new ApolloServer({
  plugins: [
    useHive({
      enabled: true,
      debug: true,
      token,
      selfHosting: {
        graphqlEndpoint: 'http://localhost:8082/graphql',
        usageEndpoint: 'http://localhost:8081',
        applicationUrl: 'http://localhost:8080/'
      },
      usage: true
    })
  ]
})

envelop.ts

import { createYoga } from 'graphql-yoga'
import { useHive } from '@graphql-hive/envelop'
 
const yoga = createYoga({
  plugins: [
    useHive({
      enabled: true,
      debug: true,
      token,
      selfHosting: {
        graphqlEndpoint: 'http://localhost:8082/graphql',
        usageEndpoint: 'http://localhost:8081',
        applicationUrl: 'http://localhost:8080/'
      },
      usage: true
    })
  ]
})

Configuring the CLI

Place a hive.json file within the root of your project.

hive.json

{
  "registry": {
    "endpoint": "http://localhost:8082/graphql"
  }
}

SSO with OIDC CDN Artifacts