Getting Started with Fluvio
Welcome! Thanks for your interest in Fluvio, the high-performance, low-latency
streaming platform for real-time applications. In this guide, we’re going to
walk through the setup process for getting started with Fluvio.
To start, we’ll show you how to install the Fluvio CLI, then later we’ll
show you how to get access to a Fluvio cluster, either locally or via
Fluvio Cloud. Note that both of these options requires you to have the
Fluvio CLI installed.
If you already have the Fluvio CLI installed, you can skip ahead to one of
the Fluvio cluster guides:
Installing the Fluvio CLI
The Fluvio CLI (command-line interface) is an all-in-one tool for setting
up, managing, and interacting with Fluvio.
Download and Install
Downloading and installing Fluvio is as simple as running the following command!
$ curl -fsS https://packages.fluvio.io/v1/install.sh | bash
If everything works successfully, you should see output similar to this:
fluvio: ⏳ Downloading Fluvio 0.6.0-rc.3 for x86_64-apple-darwin...
fluvio: ⬇️ Downloaded Fluvio, installing...
fluvio: ✅ Successfully installed ~/.fluvio/bin/fluvio
fluvio: ☁️ Installing Fluvio Cloud...
fluvio: 🎣 Fetching latest version for package: fluvio/fluvio-cloud...
fluvio: ⏳ Downloading package with latest version: fluvio/fluvio-cloud:0.1.1...
fluvio: 🔑 Downloaded and verified package file
fluvio: 🎉 Install complete!
fluvio: 💡 You'll need to add '~/.fluvio/bin/' to your PATH variable
fluvio: You can run the following to set your PATH on shell startup:
fluvio: For bash: echo 'export PATH="${HOME}/.fluvio/bin:${PATH}"' >> ~/.bashrc
fluvio: For zsh : echo 'export PATH="${HOME}/.fluvio/bin:${PATH}"' >> ~/.zshrc
fluvio:
fluvio: To use Fluvio you'll need to restart your shell or run the following:
fluvio: export PATH="${HOME}/.fluvio/bin:${PATH}"
Notice the steps it lists at the bottom. In order to use the fluvio
command,
you’ll need to make sure that ~/.fluvio/bin/
(the directory where it was installed to)
is part of your system’s PATH - the list of directories where your shell looks for
executables. Once you’ve followed those instructions, make sure you can run the following
commands:
$ fluvio version
Fluvio CLI : 0.6.0-rc.3
Fluvio Platform : 0.6.0-rc.3
Git Commit : 2aebf3b5d8f224238ccefded2f460a7f47b885fc
OS Details : Darwin 19.6.0 x86_64
Rustc Version : 1.48.0 (7eac88a 2020-11-16)
$ fluvio cloud
fluvio-cloud 0.1.1
USAGE:
fluvio-cloud <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
help Prints this message or the help of the given subcommand(s)
login Log into Fluvio Cloud with a username and password
logout Log out of a Fluvio Cloud account
Next Steps