--- title: Get started with InfluxDB description: Download, install, and setup InfluxDB, creating a default organization, user, and bucket. menu: v2_0: name: Get started weight: 1 v2.0/tags: [get-started, install] aliases: - /v2.0/cloud/get-started --- The InfluxDB 2.0 time series platform is purpose-built to collect, store, process and visualize metrics and events. Start with **InfluxDB Cloud 2.0**, a fully managed and hosted version of InfluxDB 2.0, or **InfluxDB OSS 2.0 _(beta)_**, the open source version of InfluxDB 2.0.
_See [Differences between InfluxDB Cloud and InfluxDB OSS](#differences-between-influxdb-cloud-and-influxdb-oss)._ --- ## Start with InfluxDB Cloud 2.0 ### Start for free Start using {{< cloud-name >}} at no cost with the [Free Plan](/v2.0/account-management/pricing-plans/#free-plan). Use it as much and as long as you like within the plan's rate-limits. Limits are designed to let you monitor 5-10 sensors, stacks or servers comfortably. ### Sign up 1. Choose one of the following: - **Subscribe through InfluxData** To subscribe to an InfluxDB Cloud 2.0 **Free Plan** through InfluxData, go to [InfluxDB Cloud 2.0]({{< cloud-link >}}). - To use social sign-on, click **Continue with Google**. Note that Google social sign-on does not support email aliases. - Sign up with email by entering your name, email address, and password, then click **Create Account**. If you originally signed up with email but want to enable social sign-on, you can do so by logging in through Google as long as you use the same email address. - **Subscribe through a cloud provider** To subscribe to an InfluxDB Cloud **Usage-Based** plan and pay through your **Amazon Web Services (AWS)** or **Google Cloud Platform (GCP)** account: - **AWS** Sign in to AWS, navigate to the [InfluxDB Cloud product on AWS Marketplace](https://aws.amazon.com/marketplace/pp/B08234JZPS), and follow the prompts to subscribe. After you click **Set Up Your Account**, enter your credentials, and then click **Start Now**. All usage charges will be paid through the subscribed AWS account. - **GCP** Sign in to GCP, navigate to the [InfluxDB Cloud product on GCP Marketplace](https://console.cloud.google.com/marketplace/details/influxdata-public/cloud2-gcp-marketplace-prod), and follow the prompts to subscribe. After you click **Set Up Your Account**, enter your credentials, and then click **Start Now**. All usage charges will be paid through the subscribed GCP account. {{%note%}} Currently, we do **not support** using an existing InfluxDB Cloud 2.0 account to sign up for an InfluxDB Cloud 2.0 plan through AWS or GCP Marketplaces. {{%/note%}} 2. If you signed up with your email address, InfluxDB Cloud requires email verification to complete the sign up process. Verify your email address by opening the email sent to the address you provided and clicking **Verify Your Email**. 3. (If you subscribed through InfluxData) Choose your cloud provider. 4. Select a provider and region for your {{< cloud-name >}} instance. The following are available: {{< cloud_regions type="list" >}} _To suggest regions to add, click **Let us know** under Regions._ 5. (If you subscribed through InfluxData) Review the terms of the agreement, and then select **I have viewed and agree to InfluxDB Cloud 2.0 Services Subscription Agreement and InfluxData Global Data Processing Agreement**. For details on the agreements, see the [InfluxDB Cloud 2.0: Services Subscription Agreement](https://www.influxdata.com/legal/terms-of-use/) and the [InfluxData Global Data Processing Agreement](https://www.influxdata.com/legal/influxdata-global-data-processing-agreement/). 6. Click **Finish**. {{< cloud-name >}} opens with a default organization and bucket (both created from your email address). _To update organization and bucket names, see [Update an organization](/v2.0/organizations/update-org/) and [Update a bucket](/v2.0/organizations/buckets/update-bucket/#update-a-bucket-s-name-in-the-influxdb-ui)._ {{% cloud %}} All InfluxDB 2.0 documentation applies to {{< cloud-name "short" >}} unless otherwise specified. References to the InfluxDB user interface (UI) or localhost:9999 refer to your {{< cloud-name >}} UI. {{% /cloud %}} ### (Optional) Download and install the influx CLI You can write, query, and process data through the Cloud user interface (UI) or `influx` CLI. To download and install the `influx` CLI, complete the following steps: 1. Click the **macOS** or **Linux** button below, and then click the appropriate **influx CLI** button to download the CLI binary. 2. Do one of the following: - For **macOS**: [Unpackage the binary](#unpackage-the-influx-binary), and then [(optional) place the binary in your $PATH](#optional-place-the-binary-in-your-path) - For **Linux**: [Place the binary in your $PATH](#place-the-binary-in-your-path) 3. If you're downloading on macOS Catalina, complete the steps in [Run influx CLI on macOS Catalina](/v2.0/get-started/#run-influx-cli-on-macos-catalina). 4. (Optional) To install `influx` shell completion scripts, see [`influx completion`](/v2.0/reference/cli/influx/completion/#install-completion-scripts). {{< tabs-wrapper >}} {{% tabs %}} [macOS](#) [Linux](#) {{% /tabs %}} {{% tab-content %}} #### Download influx CLI for macOS Click the following button to download and install `influx` CLI for macOS. influx CLI (macOS) #### Unpackage the influx binary To unpackage the downloaded archive, **double click the archive file in Finder** or run the following command in a macOS command prompt application such **Terminal** or **[iTerm2](https://www.iterm2.com/)**: ```sh # Unpackage contents to the current working directory tar zxvf ~/Downloads/influxdb_client_2.0.0-beta.12_darwin_amd64.tar.gz ``` #### (Optional) Place the binary in your $PATH If you choose, you can place `influx` in your `$PATH` or you can prefix the executable with `./` to run in place. ```sh # (Optional) Copy the influx binary to your $PATH sudo cp influxdb_client_2.0.0-beta.12_darwin_amd64/influx /usr/local/bin/ ``` {{% note %}} If you rename the binary, all references to `influx` in this documentation refer to the renamed binary. {{% /note %}} {{% warn %}} ##### Run influx CLI on macOS Catalina macOS Catalina requires downloaded binaries to be signed by registered Apple developers. Currently, when you first attempt to run `influx`, macOS prevents it from running. To manually authorize the binary: 1. Attempt to run the `influx`. 2. Open **System Preferences** and click **Security & Privacy**. 3. Under the **General** tab, there is a message about `influx` being blocked. Click **Open Anyway**. We are in the process of updating our build process to ensure released binaries are signed by InfluxData. {{% /warn %}} {{% /tab-content %}} {{% tab-content %}} #### Download influx CLI for Linux Click the button to download and install the `influx` CLI appropriate for your chipset. influx CLI (amd64) influx CLI (arm) #### Place the binary in your $PATH Unpackage the downloaded archive and place the `influx` executable in your system `$PATH`. _**Note:** The following commands are examples. Adjust the file names, paths, and utilities to your own needs._ ```sh # Unpackage contents to the current working directory tar xvfz influxdb_client_2.0.0-beta.12_linux_amd64.tar.gz # Copy the influx and influxd binary to your $PATH sudo cp influxdb_client_2.0.0-beta.12_linux_amd64/influx /usr/local/bin/ ``` {{% note %}} If you rename the binary, all references to `influx` in this documentation refer to the renamed binary. {{% /note %}} {{% /tab-content %}} {{< /tabs-wrapper >}} ### Sign in Sign in to [InfluxDB Cloud 2.0](https://cloud2.influxdata.com) using your email address and password. Sign in to InfluxDB Cloud 2.0 now ### Start working with your time series data With {{< cloud-name "short" >}} setup, see [Next steps](#next-steps) for what to do next. --- ## Start with InfluxDB OSS Get started with InfluxDB OSS v2.0 by downloading InfluxDB, installing the necessary executables, and running the initial setup process. {{< tabs-wrapper >}} {{% tabs %}} [macOS](#) [Linux](#) [Docker](#) [Kubernetes](#) {{% /tabs %}} {{% tab-content %}} ### Download and install InfluxDB v2.0 beta Download InfluxDB v2.0 beta for macOS. InfluxDB v2.0 beta (macOS) ### Unpackage the InfluxDB binaries To unpackage the downloaded archive, **double click the archive file in Finder** or run the following command in a macOS command prompt application such **Terminal** or **[iTerm2](https://www.iterm2.com/)**: ```sh # Unpackage contents to the current working directory tar zxvf ~/Downloads/influxdb_2.0.0-beta.12_darwin_amd64.tar.gz ``` #### (Optional) Place the binaries in your $PATH If you choose, you can place `influx` and `influxd` in your `$PATH` or you can prefix the executables with `./` to run then in place. ```sh # (Optional) Copy the influx and influxd binary to your $PATH sudo cp influxdb_2.0.0-beta.12_darwin_amd64/{influx,influxd} /usr/local/bin/ ``` {{% note %}} Both InfluxDB 1.x and 2.x include `influx` and `influxd` binaries. If InfluxDB 1.x binaries are already in your `$PATH`, run the 2.0 binaries in place or rename them before putting them in your `$PATH`. If you rename the binaries, all references to `influx` and `influxd` in this documentation refer to your renamed binaries. {{% /note %}} #### Networking ports By default, InfluxDB uses TCP port `9999` for client-server communication over the [InfluxDB HTTP API](/v2.0/reference/api/). ### Start InfluxDB Start InfluxDB by running the `influxd` daemon: ```bash influxd ``` {{% warn %}} #### Run InfluxDB on macOS Catalina macOS Catalina requires downloaded binaries to be signed by registered Apple developers. Currently, when you first attempt to run `influxd` or `influx`, macOS will prevent it from running. To manually authorize the InfluxDB binaries: 1. Attempt to run the `influx` or `influxd` commands. 2. Open **System Preferences** and click **Security & Privacy**. 3. Under the **General** tab, there is a message about `influxd` or `influx` being blocked. Click **Open Anyway**. 4. Repeat this process for both binaries. We are in the process of updating our build process to ensure released binaries are signed by InfluxData. {{% /warn %}} _See the [`influxd` documentation](/v2.0/reference/cli/influxd) for information about available flags and options._ ### Enable shell completion (Optional) To install `influx` shell completion scripts, see [`influx completion`](/v2.0/reference/cli/influx/completion/#install-completion-scripts). {{% note %}} #### InfluxDB "phone home" By default, InfluxDB sends telemetry data back to InfluxData. The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides information about what data is collected and how it is used. To opt-out of sending telemetry data back to InfluxData, include the `--reporting-disabled` flag when starting `influxd`. ```bash influxd --reporting-disabled ``` {{% /note %}} {{% /tab-content %}} {{% tab-content %}} ### Download and install InfluxDB v2.0 beta Download the InfluxDB v2.0 beta package appropriate for your chipset. InfluxDB v2.0 beta (amd64) InfluxDB v2.0 beta (arm) ### Place the executables in your $PATH Unpackage the downloaded archive and place the `influx` and `influxd` executables in your system `$PATH`. _**Note:** The following commands are examples. Adjust the file names, paths, and utilities to your own needs._ ```sh # Unpackage contents to the current working directory tar xvzf path/to/influxdb_2.0.0-beta.12_linux_amd64.tar.gz # Copy the influx and influxd binary to your $PATH sudo cp influxdb_2.0.0-beta.12_linux_amd64/{influx,influxd} /usr/local/bin/ ``` {{% note %}} Both InfluxDB 1.x and 2.x include `influx` and `influxd` binaries. If InfluxDB 1.x binaries are already in your `$PATH`, run the 2.0 binaries in place or rename them before putting them in your `$PATH`. If you rename the binaries, all references to `influx` and `influxd` in this documentation refer to your renamed binaries. {{% /note %}} #### Networking ports By default, InfluxDB uses TCP port `9999` for client-server communication over the [InfluxDB HTTP API](/v2.0/reference/api/). ### Start InfluxDB Start InfluxDB by running the `influxd` daemon: ```bash influxd ``` _See the [`influxd` documentation](/v2.0/reference/cli/influxd) for information about available flags and options._ ### Enable shell completion (Optional) To install `influx` shell completion scripts, see [`influx completion`](/v2.0/reference/cli/influx/completion/#install-completion-scripts). {{% note %}} #### InfluxDB "phone home" By default, InfluxDB sends telemetry data back to InfluxData. The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides information about what data is collected and how it is used. To opt-out of sending telemetry data back to InfluxData, include the `--reporting-disabled` flag when starting `influxd`. ```bash influxd --reporting-disabled ``` {{% /note %}} {{% /tab-content %}} {{% tab-content %}} ### Download and run InfluxDB v2.0 beta Use `docker run` to download and run the InfluxDB v2.0 beta Docker image. Expose port `9999`, which InfluxDB uses for client-server communication over the [InfluxDB HTTP API](/v2.0/reference/api/). ```sh docker run --name influxdb -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-beta ``` _To run InfluxDB in [detached mode](https://docs.docker.com/engine/reference/run/#detached-vs-foreground), include the `-d` flag in the `docker run` command._ {{% note %}} #### InfluxDB "phone home" By default, InfluxDB sends telemetry data back to InfluxData. The [InfluxData telemetry](https://www.influxdata.com/telemetry) page provides information about what data is collected and how it is used. To opt-out of sending telemetry data back to InfluxData, include the `--reporting-disabled` flag when starting the InfluxDB container. ```bash docker run -p 9999:9999 quay.io/influxdb/influxdb:2.0.0-beta --reporting-disabled ``` {{% /note %}} ### Console into the InfluxDB Container (Optional) To use the `influx` command line interface, console into the `influxdb` Docker container: ```bash docker exec -it influxdb /bin/bash ``` {{% /tab-content %}} {{% tab-content %}} ### Install InfluxDB in a Kubernetes cluster {{% note %}} The instructions below use Minikube, but the steps should be similar in any Kubernetes cluster. {{% /note %}} 1. [Install Minikube](https://kubernetes.io/docs/tasks/tools/install-minikube/). 2. Start Minikube: ```sh minikube start ``` 3. Apply the [sample InfluxDB configuration](https://github.com/influxdata/docs-v2/blob/master/static/downloads/influxdb-k8-minikube.yaml) by running: ```sh kubectl apply -f https://raw.githubusercontent.com/influxdata/docs-v2/master/static/downloads/influxdb-k8-minikube.yaml ```
Always inspect YAML manifests before running kubectl apply -f <url>
!