Quick Start
Last updated
Was this helpful?
Last updated
Was this helpful?
This Quick Start guide shows how to run your first Bacalhau job with minimal setup. Bacalhau's design as a single self-contained binary makes it incredibly easy to set up your own distributed compute network in minutes.
Docker installed on any machine that runs a compute node
Bacalhau CLI installed (see below)
Install Bacalhau using the one-liner below (Linux/macOS) or see the for Windows and Docker options.
Once installed, verify with:
Open a terminal and run:
This command launches both an orchestrator and a compute node in one process
Keep it running; you'll see logs indicating it's ready
Bacalhau supports two primary methods of job submission: Imperative (CLI) and Declarative (YAML). We'll demonstrate a word count job on the classic novel Moby Dick.
The job downloads a sample dataset and processes it locally
Bacalhau will display job progress until completion
You'll receive a Job ID once the job is submitted
Replace <jobID>
with the actual ID printed in step 2
You can run bacalhau job logs <job-id>
to just get the execution logs
Download and view your job results:
Note: You should see a word frequency analysis of the Moby Dick text file!
You've just:
Started a local Bacalhau network
Submitted a job using both imperative and declarative methods
Tracked job progress with detailed descriptions
Retrieved and viewed job results