Skip to main content

Getting Started with the Public Bacalhau Network

Install the CLI​

curl -sL https://get.bacalhau.org/install.sh | bash

Run a "hello world" job​

bacalhau docker run ubuntu echo hello
[2207] INF jsonrpc/jsonrpc_client.go:73 > Submitted Job Id: fa11069f-17e0-47de-b8b5-37444cb396b5
fa11069f-17e0-47de-b8b5-37444cb396b5

Copy the first part of the job id, such as fa11069f, we'll use it in a moment.

bacalhau list --wide --sort-by=id --id-filter=<JOB_ID>

Replace JOB_ID with the job id you copied in the last step.

Only one of the production servers accepted the job, because you only requested a concurrency setting of 1 (the default in bacalhau docker run).

You should see something like

 fa11069f   QmdZQ7Zb  bid_rejected  /ipfs/
            QmXaXu9N  complete      /ipfs/QmQtZKRPXehLU5JroBbzBCVdhNkgZT7m4MiSD7sUVxE3LD
            QmYgxZiy  bid_rejected  /ipfs/

Copy the JOB_ID (in this case fa11069f), and run:

bacalhau get JOB_ID

You should see the following:

[2207] INF bacalhau/get.go:35 > Fetching results of job 'fa11069f'...
[...]
[2207] INF ipfs/downloader.go:101 > Copying output volume outputs

Now read the stdout

cat stdout
hello

Hooray, you have just run a job on the Bacalhau network!

Demo Video​

Here is an example of running a job live on the Bacalhau network: Youtube: Bacalhau Intro Video

Support​

Please reach out to the Bacalhau team via Slack if you would like help pinning data to IPFS for your job or in case of any issues.