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


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


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:

Form for a new gRPC resource. Service names are parsed from the proto files.Form for a new gRPC resource. Service names are parsed from the proto files.

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!

Updated about a month ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.