Skip to main content



The only system wide dependency required by pebl is docker. To install docker you can follow the directions at


Currently the SDK is supported in Python, Go, and Node.js.


The Python workflow is all done through Docker, so the only requirement is a valid Dockerfile built on top of one of pebl's pre-built images. (Technically you don't even need Python installed on your local machine!)

For convenience you can stick with the floating tag: peblcloud/python. This will always point to the latest SDK version and the latest stable Python release. If you want a more predictable workflow you can always specify the SDK and Python version.


The Go workflow requires Go to be installed on the local system. We support Go 1.19 and up, and in general recommend that you utilize Go Modules in your projects.

The Go SDK is provided as regular package and you can simply run go get in your desired projects.


The Node workflow requires Node version 20+ to be installed on your system.

The Node package for pebl is provided as an npm package

pebl CLI

The pebl cli is currently available for three targets, M1 Mac, Intel Mac, and AMD64 Linux. If your target system isn't available, please let us know at

install script

The easiest way is to use our install script which determines the correct target. Paste the following into your shell:

curl | sh

If you are curious, you can inspect the install script:

manual install

If you want more control over where the pebl binary is placed, you can manually download using curl. Make sure to choose the correct option based on your system. This will unzip a binary named pebl in the working directory.

curl \
--progress-bar \
--output \ \
&& unzip \
&& chmod +x pebl

Once unzipped, we recommend placing the pebl binary on your $PATH so that you don't have to specify the whole path when executing the pebl cli.

So something like mv pebl /usr/local/bin (or any other desired folder) should work.


This is an optional step. A valid auth token is required for utilizing pebl's cloud runtime.

Simply run pebl auth and follow the instructions.


Now let's run through a simple project to make sure you are set up properly!

Check out our github

$ git clone

Navigate to our helloworld example ( and follow the steps in the

$ cd examples/helloworld
$ pebl up
:: initializing new pebl cluster...
:: done!
:: run `pebl info` to see logs, endpoints, and other info about the running cluster!
$ pebl run
:: building docker project...
:: starting container...
$ pebl info

If you see the info pane with "hello, world!" in the logs, you have properly configured pebl! 🎉