docs-v2/content/influxdb3/enterprise/install.md

6.5 KiB

title description menu weight influxdb3/enterprise/tags alt_links
Install {{< product-name >}} Download and install {{< product-name >}}.
influxdb3_enterprise
name
Install InfluxDB 3 Enterprise
2
install
v1
/influxdb/v1/introduction/install/

System Requirements

Operating system

{{< product-name >}} runs on Linux, macOS, and Windows.

Object storage

A key feature of InfluxDB 3 is its use of object storage to store time series data in Apache Parquet format. You can choose to store these files on your local file system. Performance on your local filesystem will likely be better, but object storage has the advantage of not running out of space and being accessible by other systems over the network. {{< product-name >}} natively supports Amazon S3, Azure Blob Storage, and Google Cloud Storage. You can also use many local object storage implementations that provide an S3-compatible API, such as Minio.

Quick install

Use the InfluxDB 3 quick install script to install {{< product-name >}} on Linux and macOS.

[!Important] If using Windows, [download the {{% product-name %}} Windows binary](?t=Windows#download-influxdb-3-{{< product-key >}}-binaries).

  1. Use the following command to download and install the appropriate {{< product-name >}} package on your local machine:

    curl -O https://www.influxdata.com/d/install_influxdb3.sh \
    && sh install_influxdb3.sh enterprise
    
  2. Verify that installation completed successfully:

    influxdb3 --version
    

[!Note]

influxdb3 not found

If your system can't locate your influxdb3 binary, source your current shell configuration file (.bashrc, .zshrc, etc.).

{{< code-tabs-wrapper >}} {{% code-tabs %}} .bashrc .zshrc {{% /code-tabs %}} {{% code-tab-content %}}

source ~/.bashrc

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

source ~/.zshrc

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

Download {{< product-name >}} binaries

{{< tabs-wrapper >}} {{% tabs %}} Linux macOS Windows {{% /tabs %}} {{% tab-content %}}

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

[!Note] macOS Intel builds are coming soon.

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

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

Docker image

Use the influxdb:3-{{< product-key >}} Docker image to deploy {{< product-name >}} in a Docker container. The image is available for x86_64 (AMD64) and ARM64 architectures.

Use Docker CLI

docker pull influxdb:3-{{< product-key >}}

Docker automatically pulls the appropriate image for your system architecture.

To specify the system architecture, use platform-specific tags--for example:

# For x86_64/AMD64
docker pull \
--platform linux/amd64 \
influxdb:3-{{< product-key >}}
# For ARM64
docker pull \
--platform linux/arm64 \
influxdb:3-{{< product-key >}}

[!Note] The {{% product-name %}} Docker image exposes port 8181, the influxdb3 server default for HTTP connections. To map the exposed port to a different port when running a container, see the Docker guide for Publishing and exposing ports.

Use Docker Compose

  1. Open compose.yaml for editing and add a services entry for {{% product-name %}}--for example:

    # compose.yaml
    services:
      influxdb3-{{< product-key >}}:
        container_name: influxdb3-{{< product-key >}}
        image: influxdb:3-{{< product-key >}}
        ports:
          - 9999:9999
        command:
          - influxdb3
          - serve
          - --node-id=node0
          - --cluster-id=cluster0
          - --object-store=file
          - --data-dir=/var/lib/influxdb3
    
  2. Use the Docker Compose CLI to start the server.

    Optional: to make sure you have the latest version of the image before you start the server, run docker compose pull.

    docker compose pull && docker compose run influxdb3-{{< product-key >}}
    

[!Note]

Stopping an InfluxDB 3 container

To stop a running InfluxDB 3 container, find and terminate the process--for example:

ps -ef | grep influxdb3
kill -9 <PROCESS_ID>

Currently, a bug prevents using {{< keybind all="Ctrl+c" >}} in the terminal to stop an InfluxDB 3 container.

{{< page-nav next="/influxdb3/enterprise/get-started/" nextText="Get started with InfluxDB 3 Enterprise" >}}