Skip to content

Getting started

The best way to get to know Pravega is to start it up and run a sample Pravega application.

Running Pravega is simple

Verify the following prerequisite:

Java 8

Download Pravega

Download the Pravega release from the github releases page. If you prefer to build Pravega yourself, you can download the code and run ./gradlew distribution. More details are shown in the Pravega

$ tar xfvz pravega-<version>.tgz

Run Pravega in standalone mode

This launches all the components of Pravega on your local machine. NOTE: this is for testing/demo purposes only, do not use this mode of deployment in Production! More options for Running Pravega are covered in the running Pravega guide.

$ cd pravega-<version>
$ bin/pravega-standalone

That's it. Pravega should be up and running very soon.

You can find additional ways to run Pravega in Running Pravega.

Running a sample Pravega App is simple too

Pravega maintains a separate github repository for sample applications. It is located at:

Lets download and run the "Hello World" Pravega sample reader and writer apps. Pravega dependencies will be pulled from maven central.

Note: The samples can also use a locally compiled version of Pravega. For more information about this see the note on maven publishing in the

Download the Pravega-Samples git repo

$ git clone
$ cd pravega-samples

Generate the scripts to run the apps

$ ./gradlew installDist

Run the sample "HelloWorldWriter" This runs a simple Java application that writes a "hello world" message as an event into a Pravega stream.

$ cd pravega-samples/pravega-client-examples/build/install/pravega-client-examples
$ bin/helloWorldWriter
Example HelloWorldWriter output
Writing message: 'hello world' with routing-key: 'helloRoutingKey' to stream 'examples / helloStream'
See the file in the standalone-examples for more details on running the HelloWorldWriter with different parameters

Run the sample "HelloWorldReader"

$ cd pravega-samples/pravega-client-examples/build/install/pravega-client-examples
$ bin/helloWorldReader

Example HelloWorldReader output

Reading all the events from examples/helloStream
Read event 'hello world'
No more events from examples/helloStream

See the file in the pravega-client-examples for more details on running the HelloWorldReader application