docs-v2/content/influxdb/cloud-dedicated/get-started/setup.md

title	seotitle	list_title	description	menu	weight	metadata	related
Set up InfluxDB Cloud Dedicated	Set up InfluxDB | Get started with InfluxDB Cloud Dedicated	Set up InfluxDB	Learn how to set up InfluxDB Cloud Dedicated for the "Get started with InfluxDB" tutorial and for general use.	influxdb_cloud_dedicated name parent identifier Set up InfluxDB Get started get-started-set-up	101	1 / 3	/influxdb/cloud-dedicated/admin/databases/ /influxdb/cloud-dedicated/reference/cli/influxctl/ /influxdb/cloud-dedicated/reference/api/

As you get started with this tutorial, do the following to make sure everything you need is in place.

• Request an InfluxDB Cloud Dedicated cluster
• Download, install, and configure the influxctl CLI
• Create a database
• Create a database token
• Configure authentication credentials

Request an InfluxDB Cloud Dedicated cluster

[Contact the InfluxData Sales team]({{< dedicated-link >}}) to request an InfluxDB Cloud Dedicated cluster. When your cluster is deployed, your InfluxData account representative provides the following:

• An Auth0 login to authenticate access to your cluster
• Your InfluxDB Cloud Dedicated account ID
• Your InfluxDB Cloud Dedicated cluster ID
• Your InfluxDB Cloud Dedicated cluster URL

Download, install, and configure the influxctl CLI

The influxctl CLI provides a simple way to manage your InfluxDB Cloud Dedicated cluster from a command line. It lets you perform administrative tasks such as managing databases and tokens.

1. Download and install the influxctl CLI.

2. Create a connection profile and provide your InfluxDB Cloud Dedicated connection credentials.

   The influxctl CLI uses connection profiles to connect to and authenticate with your InfluxDB Cloud Dedicated cluster.

   Create a file named config.toml at the following location depending on your operating system.

   Operating system	Default profile configuration file path
   Linux	~/.config/influxctl/config.toml
   macOS	~/Library/Application Support/influxctl/config.toml
   Windows	%APPDATA%\influxctl\config.toml

   {{% note %}} If stored at a non-default location, include the --config flag with each influxctl command and provide the path to your profile configuration file. {{% /note %}}

   Copy and paste the sample configuration profile code into your config.toml and replace the following with your {{< cloud-name >}} credentials:

   • ACCOUNT_ID: Your account ID
   • CLUSTER_ID: Your cluster ID

{{% code-placeholders "ACCOUNT_ID|CLUSTER_ID" %}}

[[profile]]
  name = "default"
  product = "dedicated"
  account_id = "ACCOUNT_ID"
  cluster_id = "CLUSTER_ID"

{{% /code-placeholders %}}

For detailed information about influxctl profiles, see Configure connection profiles.

Create a database

Use the influxctl database create command to create a database. You can use an existing database or create a new one specifically for this getting started tutorial. Examples in this getting started tutorial assume a database named "get-started".

{{% note %}}

Authenticate with your cluster

The first time you run an influxctl CLI command, you are directed to login to Auth0. Once logged in, Auth0 issues a short-lived (1 hour) management token for the influxctl CLI that grants administrative access to your InfluxDB Cloud Dedicated cluster. {{% /note %}}

Provide the following:

• Database name.
• Optional: Database retention period as a duration value. If no retention period is specified, the default is infinite.

{{% code-placeholders "get-started|1y" %}}

influxctl database create --retention-period 1y get-started

{{% /code-placeholders %}}

Create a database token

Use the influxctl token create command to create a database token with read and write permissions for your database.

Provide the following:

• Permission grants
  • --read-database: Grants read access to a database
  • --write-database Grants write access to a database
• Token description

{{% code-placeholders "get-started" %}}

influxctl token create \
  --read-database get-started \
  --write-database get-started \
  "Read/write token for get-started database"

{{% /code-placeholders %}}

The command returns the token ID and the token string. Store the token string in a safe place. You'll need it later. This is the only time the token string is available in plain text.

{{% note %}}

Store secure tokens in a secret store

Token strings are returned only on token creation. We recommend storing database tokens in a secure secret store. For example, see how to authenticate Telegraf using tokens in your OS secret store. {{% /note %}}

Configure authentication credentials

Code samples in later sections assume you assigned the token string to an INFLUX_TOKEN environment variable--for example:

{{< tabs-wrapper >}} {{% tabs %}} MacOS and Linux PowerShell CMD {{% /tabs %}} {{% tab-content %}}

{{% code-placeholders "DATABASE_TOKEN" %}}

export INFLUX_TOKEN=DATABASE_TOKEN

{{% /code-placeholders %}}

{{% /tab-content %}} {{% tab-content %}}

{{% code-placeholders "DATABASE_TOKEN" %}}

$env:INFLUX_TOKEN = "DATABASE_TOKEN"

{{% /code-placeholders %}}

{{% /tab-content %}} {{% tab-content %}}

{{% code-placeholders "DATABASE_TOKEN" %}}

set INFLUX_TOKEN=DATABASE_TOKEN 
# Make sure to include a space character at the end of this command.

{{% /code-placeholders %}}

{{% /tab-content %}} {{< /tabs-wrapper >}}

Replace DATABASE_TOKEN with your database token string.

{{< page-nav prev="/influxdb/cloud-dedicated/get-started/" next="/influxdb/cloud-dedicated/get-started/write/" keepTab=true >}}