Back to Tooljet

gRPC

docs/versioned_docs/version-2.50.0-LTS/data-sources/grpc.md

3.20.154-lts2.1 KB
Original Source
<div className='badge badge--primary heading-badge'>Self-hosted only</div>

:::caution Only self-hosted deployments will have access to a gRPC datasource that is capable of handling unary requests and responses. :::

<div style={{paddingTop:'24px'}}>

Setup

Step 1: Upgrade ToolJet to the Version 2.5 or Above

Find instructions on how to do this in the setup guides located here: ToolJet Setup.

Step 2: Add Proto Files

At the root, create a directory named "protos" and add a "service.proto" file inside it.

Step 3: Mount Volumes

In the docker-compose.yml add the following to the volumes sections for plugins and server

bash
./protos:/app/protos

Step 4: Reboot the Instance

bash
docker-compose up -d
</div> <div style={{paddingTop:'24px'}}>

Querying gRPC

After setting up your proto files, you should be able to establish a connection to gRPC by going to the global datasource page.

Connect the gRPC Datasource

ToolJet requires the following to connect to gRPC servers:

  • Server URL
  • Authentication type
    • None
    • Basic
    • Bearer
    • API key
<div style={{textAlign: 'center'}}> </div>

Once you have added the gRPC from the global datasource page, you'll find it on the query panel of the application.

<div style={{textAlign: 'center'}}> </div>

Creating Query

You can now query a particular RPC method of the added services.

<div style={{textAlign: 'center'}}> </div> </div>