Skip to content

Commit 30b8cd1

Browse files
authored
Add info about docker pitfalls to README (#258)
1 parent a8f79c8 commit 30b8cd1

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,10 @@ docker pull fullstorydev/grpcurl:latest
6565
# Run the tool
6666
docker run fullstorydev/grpcurl api.grpc.me:443 list
6767
```
68+
Note that there are some pitfalls when using docker:
69+
- If you need to interact with a server listening on the host's loopback network, you must specify the host as `host.docker.internal` instead of `localhost` (for Mac or Windows) _OR_ have the container use the host network with `-network="host"` (Linux only).
70+
- If you need to provide proto source files or descriptor sets, you must mount the folder containing the files as a volume (`-v $(pwd):/protos`) and adjust the import paths to container paths accordingly.
71+
- If you want to provide the request message via stdin, using the `-d @` option, you need to use the `-i` flag on the docker command.
6872

6973
### Other Packages
7074

0 commit comments

Comments
 (0)