🚧

gRPC is currently available for on premise deployments and supports unary requests and responses today.

In addition to REST and GraphQL based APIs, Retool supports connecting to services via gRPC. Here is how you can setup gRPC endpoints for your deployment.

gRPC Setup

1. Update Retool to the latest build

./update_retool.sh

2. Add proto files

On the host machine create a protos/ folder and add the .proto files into there

3. Mount Volumes

In the docker-compose.yml add

- ./protos:/retool_backend/protos

to the 3 volume sections for api, db-connector and db-ssh-connector

4. Add folder path ENV Variable

In docker.env add the path to the proto files

PROTO_DIRECTORY_PATH=/retool_backend/protos

Retool will automatically include the Google proto files and the '/retool_backend/protos' folder in the include directories. If your proto files use imports which rely on a different base folder you can add that directory to the PROTO_IMPORT_DIRECTORY_PATH env variable and it will also include that path.

5. Restart Retool

sudo docker-compose up -d

Creating a gRPC Resource

Now that your proto files are setup you should be able to select gRPC under APIs and see the service names for your proto files in the list:

 
Once you have a resource connected you can create a query using it. The methods/rpc’s for that service will be available in the query. Placeholder JSON is generated to match the Request message.

 
Then you can use your query in your apps

 
Let us know if you have any questions or run into any roadblocks!