Install InfluxDB 3 Core
InfluxDB 3 Core is in Public Alpha
InfluxDB 3 Core is in public alpha and available for testing and feedback, but is not meant for production use. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the alpha and invite you to join our public channels for updates and to share feedback.
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.
If using Windows, download the InfluxDB 3 Core Windows binary.
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.shVerify that installation completed successfully:
influxdb3 --version
influxdb3 not found
If your system can’t locate your influxdb3 binary, source your
current shell configuration file (.bashrc, .zshrc, etc.).
Download InfluxDB 3 Core binaries
macOS Intel builds are coming soon.
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 quay.io/influxdb/influxdb3-core:latest
Docker automatically pulls the appropriate image for your system architecture.
You can also explicitly specify the architecture by using platform-specific tags:
# For x86_64/AMD64
docker pull \
--platform linux/amd64 \
quay.io/influxdb/influxdb3-core:latest
# For ARM64
docker pull \
--platform linux/arm64 \
quay.io/influxdb/influxdb3-core:latest
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
Open
compose.yamlfor editing and add aservicesentry for InfluxDB 3 Core–for example:# compose.yaml services influxdb3-core: container_name: influxdb3-core image: quay.io/influxdb/influxdb3-core
:latest ports: - 9999:9999 command: - serve - –node-id=node0 - –log-filter=debug - –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`.
<!--pytest.mark.skip-->
```bash
docker compose pull && docker compose run influxdb3-core
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 Ctrl-c in the terminal to stop an InfluxDB 3 container.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Core and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.