Quickstart

This guide walks you through installing FlareDB, starting a local instance, and running a WordCount pipeline on FlareDB. By the end, you’ll have a running FlareDB instance with a WordCount pipeline successfully submitted and executed.

1. Install the FlareDB CLI

The flare CLI lets you initialize and manage FlareDB instances, and provides an interactive SQL shell for querying your data.

curl -sSL https://install.flare-db.com | bash

The installer script detects your platform (linux or macOS), downloads the latest release, and installs the flare CLI. If you are on Windows, use WSL.

2. Initialize FlareDB

flare init

This creates the local ~/.flaredb directory and downloads the components required to run FlareDB. This is a one time setup.

3. Start an instance

flare up

FlareDB starts a local instance on port 8099 and is ready to accept pipeline jobs.

The local instance stores its data under ~/.flaredb, including tables created through the SQL shell and data written by pipelines.

4. Run a pipeline

Clone the repository and run the WordCount example:

git clone https://github.com/flare-db/flare-db.git
cd flare-db

# Build the example.
./gradlew :wordcount:shadowJar

# Submit the pipeline to the running FlareDB instance.
./gradlew :wordcount:run

The run task starts com.flaredb.example.WordCount and submits the pipeline to your local FlareDB instance. To learn how to build and run your own pipelines, see Run a Beam pipeline.

5. Stop the instance

flare down

This stops the running FlareDB instance. Run flare up again when you want to start it.

Next steps

Python quickstart - Getting started with running python pipelines on FlareDB
Run a Beam pipeline - Add the FlareDB runner to your own project.

For a complete list of CLI commands and options, see the CLI reference.

Intoduction

Guides

1. Install the FlareDB CLI

2. Initialize FlareDB

3. Start an instance

4. Run a pipeline

5. Stop the instance

Next steps

​1. Install the FlareDB CLI

​2. Initialize FlareDB

​3. Start an instance

​4. Run a pipeline

​5. Stop the instance

​Next steps

1. Install the FlareDB CLI

2. Initialize FlareDB

3. Start an instance

4. Run a pipeline

5. Stop the instance

Next steps