README.md
1# gRPC in 3 minutes (C++)
2
3## Installation
4
5To install gRPC on your system, follow the instructions to build from source
6[here](../../BUILDING.md). This also installs the protocol buffer compiler
7`protoc` (if you don't have it already), and the C++ gRPC plugin for `protoc`.
8
9## Hello C++ gRPC!
10
11Here's how to build and run the C++ implementation of the [Hello
12World](../protos/helloworld.proto) example used in [Getting started](..).
13
14### Client and server implementations
15
16The client implementation is at [greeter_client.cc](helloworld/greeter_client.cc).
17
18The server implementation is at [greeter_server.cc](helloworld/greeter_server.cc).
19
20### Try it!
21Build client and server:
22
23```sh
24$ make
25```
26
27Run the server, which will listen on port 50051:
28
29```sh
30$ ./greeter_server
31```
32
33Run the client (in a different terminal):
34
35```sh
36$ ./greeter_client
37```
38
39If things go smoothly, you will see the "Greeter received: Hello world" in the
40client side output.
41
42## Tutorial
43
44You can find a more detailed tutorial in [gRPC Basics: C++](cpptutorial.md)
45