Skip to content
/ grpcox Public

Like Postman, but for gRPC: web based GUI client for gRPC Development Testing

License

Notifications You must be signed in to change notification settings

gusaul/grpcox

Repository files navigation

gRPCox

Go Report Card

turn gRPCurl into web based UI, extremely easy to use

Features

  • Recognize and provide list of services and methods inside it as an options.
  • Automatically recognize schema input and compose it into JSON based. (ensure your gRPC server supports server reflection). Examples for how to set up server reflection can be found here.
  • Save established connection, and reuse it for next invoke/request (also can close/restart connection)

Installation

Docker

docker pull gusaul/grpcox:latest

then run

docker run -p 6969:6969 -v {ABSOLUTE_PATH_TO_LOG}/log:/log -d gusaul/grpcox

Docker Compose

from terminal, move to grpcox directory, then run command

docker-compose up

if you're using docker and want to connect gRPC on your local machine, then use
host.docker.internal:<your gRPC port> instead of localhost

Golang

if you have golang installed on your local machine, just run command

make start

from grpcox directory

configure app preferences by editing config.env file

var usage type unit
MAX_LIFE_CONN maximum idle time connection before closed number minute
TICK_CLOSE_CONN ticker interval to sweep expired connection number second
BIND_ADDR ip:port to bind service string

set value 0 (zero) to disable auto close idle connection.

Demo

gRPCox Demo