Difficulty: beginner
Estimated Time: 10-15 minutes

Getting Started

In this scenario, you'll learn how to launch InfluxDB to start collecting system metrics from nodes within your system.


InfluxDB is an open source time series platform. This includes APIs for storing and querying data, processing it in the background for ETL or monitoring and alerting purposes, user dashboards, and visualizing and exploring the data and more.

Getting Started with InfluxDB

Thanks for taking part!

Getting Started with InfluxDB 2.x

Step 1 of 3

Step 1: Starting InfluxDB

Starting InfluxDB

InfluxDB 2.0 is currently in alpha and we do not recommend using these instructions as a basis for any production workloads.

InfluxDB can be run as a Docker container using our pre-built alpha Docker image, available on Quay.io. InfluxDB 2.0 ships with a UI, available on port 9999.

Running InfluxDB

First, lets create a directory on the host to persist our InfluxDB data.

# Lets make a directory to persist our data
mkdir -p /influxdb/data

Next, we'll create a Docker network so that our InfluxDB container can be contacted by some extra containers later.

docker network create influxdb

The following Docker command spins up an InfluxDB 2.0 container, which persists data in /root/.influxdbv2, and is mapped back to the host on the directory we created earlier.

docker run -d \
    --volume "/influxdb/data:/root/.influxdbv2" \
    --publish "19999:9999" \
    --network "influxdb" \
    --name "influxdb" \

Once started, the dashboard is viewable on port 9999. The next steps will explain the details and how to view the data.

Configuring InfluxDB Authentication

Authentication cannot be disabled with InfluxDB 2.0, so we also need to configure our organisation and user.

docker container run \
    --network "influxdb" \
    quay.io/influxdb/influxdb:2.0.0-alpha \
    influx setup --host "http://influxdb:9999" --org bigcorp --bucket default --username p.dix --password einstein --token backtothefuture --force
This tab will not be visible to users and provides only information to help authors when creating content.

Creating Katacoda Scenarios

Thanks for creating Katacoda scenarios. This tab is designed to help you as an author have quick access the information you need when creating scenarios.

Here are some useful links to get you started.

Running Katacoda Workshops

If you are planning to use Katacoda for workshops, please contact [email protected] to arrange capacity.

Debugging Scenarios

Below is the response from any background scripts run or files uploaded. This stream can aid debugging scenarios.

If you still need assistance, please contact [email protected]