Documentation

Getting Started with Fluvio Cloud

Fluvio Cloud is the fastest and easiest way to get started with Fluvio. We’ll walk you through the steps of creating a free account and connecting to it with a Fluvio client.

You can reach us on Discord or in Github.

Prerequisites 

Before getting started, make sure you have the Fluvio CLI installed, as we’ll be using that to interact with your cluster and make sure everything is working as expected.

Creating a Fluvio Cloud account 

Head on over to the Fluvio Cloud signup page to create an account.

Fluvio Cloud signup

After filling out the form, you’ll be greeted with a success message telling you to verify your email. You’ll need to complete this step in order to continue.

Fluvio Cloud verification

You should get a confirmation that your account is ready to use

Fluvio Cloud confirmation

At this point, we can log in via the Fluvio CLI and start sending and receiving messages to your Fluvio cluster. To log in with the CLI, you’ll need to run the fluvio cloud login command, then type in your email and password when prompted.

$ fluvio cloud login
Fluvio Cloud email: batman@justiceleague.com
Password:

You’ll be able to tell that everything worked if your current profile is set to cloud. You can check with this command:

$ fluvio profile current
cloud

If you installed fluvio locally it will be listed alongside cloud:

$ fluvio profile view
    PROFILE       CLUSTER       ADDRESS                          TLS 
    local         local         localhost:9003                   Disabled 
 *  cloud         cloud         router.cloud.fluvio.io:9003      Verified

Hello, Fluvio! 

Congratulations, you’ve successfully set up Fluvio Cloud! Let’s use the Fluvio CLI to play with some basic functionality.

The first thing we need to do is create a Fluvio topic. A Topic is like a category where related events live together. We can create a new topic with the following command:

$ fluvio topic create greetings
topic "greetings" created

Now that we have a topic, we can produce some messages! Use the following command to send a message to the greetings topic:

$ echo "Hello, Fluvio" | fluvio produce greetings
Ok!

Finally, we can consume messages back from the topic

$ fluvio consume greetings -B -d
Hello, Fluvio

Way to go! You’re well on your way to writing real-time distributed apps with Fluvio!

Next, check out our Tutorials page to see real-world examples of Fluvio in action.