Documentation

Install InfluxDB 3 Enterprise

System Requirements

Operating system

InfluxDB 3 Enterprise 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. InfluxDB 3 Enterprise 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 InfluxDB 3 Enterprise on Linux and macOS.

  1. Use the following command to download and install the appropriate InfluxDB 3 Enterprise package on your local machine:

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

    influxdb3 --version
    
    • Copy
    • Fill window

influxdb3 not found

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

source ~/.bashrc
  • Copy
  • Fill window
source ~/.zshrc
  • Copy
  • Fill window

Download InfluxDB 3 Enterprise binaries

Docker image

Use the influxdb3-enterprise Docker image to deploy InfluxDB 3 Enterprise in a Docker container. The image is available for x86_64 (AMD64) and ARM64 architectures.

Use Docker CLI

docker pull quay.io/influxdb/influxdb3-enterprise:latest
  • Copy
  • Fill window

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 \
quay.io/influxdb/influxdb3-enterprise:latest
  • Copy
  • Fill window
# For ARM64
docker pull \
--platform linux/arm64 \
quay.io/influxdb/influxdb3-enterprise:latest
  • Copy
  • Fill window

The InfluxDB 3 Enterprise 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 InfluxDB 3 Enterprise–for example:

    # compose.yaml
    services:
      influxdb3-enterprise:
        container_name: influxdb3-enterprise
        image: quay.io/influxdb/influxdb3-enterprise:latest
        ports:
          - 9999:9999
        command:
          - serve
          - --node-id=node0
          - --cluster-id=cluster0
          - --object-store=file
          - --data-dir=/var/lib/influxdb3
    
    • Copy
    • Fill window
  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-enterprise
    
    • Copy
    • Fill window

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>
  • Copy
  • Fill window

Currently, a bug prevents using Ctrl+c in the terminal to stop an InfluxDB 3 container.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

Now Generally Available

InfluxDB 3 Core and Enterprise

Start fast. Scale faster.

Get the Updates

InfluxDB 3 Core is an open source, high-speed, recent-data engine that collects and processes data in real-time and persists it to local disk or object storage. InfluxDB 3 Enterprise builds on Core’s foundation, adding high availability, read replicas, enhanced security, and data compaction for faster queries and optimized storage. A free tier of InfluxDB 3 Enterprise is available for non-commercial at-home or hobbyist use.

For more information, check out: