Documentation

Install InfluxDB 3 Core

System Requirements

Operating system

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

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

    curl -O https://www.influxdata.com/d/install_influxdb3.sh \
    && sh install_influxdb3.sh
    
    • 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 Core binaries

Docker image

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

Use Docker CLI

docker pull influxdb:3-core
  • 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 \
influxdb:3-core
  • Copy
  • Fill window
# For ARM64
docker pull \
--platform linux/arm64 \
influxdb:3-core
  • Copy
  • Fill window

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

    # compose.yaml
    services:
      influxdb3-core:
        container_name: influxdb3-core
        image: influxdb:3-core
        ports:
          - 9999:9999
        command:
          - influxdb3
          - serve
          - --node-id=node0
          - --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-core
    
    • 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: