---
title: Install InfluxDB 3 Enterprise
description: Download and install InfluxDB 3 Enterprise.
url: https://docs.influxdata.com/influxdb3/enterprise/install/
estimated_tokens: 5579
product: InfluxDB 3 Enterprise
version: enterprise
---

# Install InfluxDB 3 Enterprise

-   [System Requirements](#system-requirements)
-   [Install](#install)
    -   [Quick install for Linux and macOS](#quick-install-for-linux-and-macos)
    -   [Download and install the latest build artifacts](#download-and-install-the-latest-build-artifacts)
    -   [Pull the Docker image](#pull-the-docker-image)
    -   [Linux DEB or RPM](#linux-deb-or-rpm)
        -   [TOML configuration (Linux)](#toml-configuration-linux)
        -   [Run as a system service (Linux)](#run-as-a-system-service-linux)
    -   [Verify the installation](#verify-the-installation)

#### Upgrading from InfluxDB 3 Core?

If you’re currently running InfluxDB 3 Core and want to upgrade to InfluxDB 3 Enterprise, see [Upgrade from Core](/influxdb3/enterprise/admin/upgrade-from-core/) for step-by-step instructions.

#### Multi-node cluster setup

For information about setting up a multi-node InfluxDB 3 Enterprise cluster, see [Create a multi-node cluster](/influxdb3/enterprise/get-started/multi-server/) in the Get started guide.

For steps to upgrade an existing InfluxDB 3 Enterprise cluster, see [Upgrade InfluxDB](/influxdb3/enterprise/admin/upgrade/).

## 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](https://min.io/).

## Install

InfluxDB 3 Enterprise runs on **Linux**, **macOS**, and **Windows**.

Choose one of the following methods to install InfluxDB 3 Enterprise:

-   [Quick install for Linux and macOS](#quick-install-for-linux-and-macos)
-   [Download and install the latest build artifacts](#download-and-install-the-latest-build-artifacts)
-   [Pull the Docker image](#pull-the-docker-image)
-   [Linux DEB or RPM](#linux-deb-or-rpm)

### Quick install for Linux and macOS

To install InfluxDB 3 Enterprise on **Linux** or **macOS**, download and run the quick installer script for InfluxDB 3 Enterprise–for example, using [`curl`](https://curl.se/) to download the script:

```bash
curl -O https://www.influxdata.com/d/install_influxdb3.sh \
&& sh install_influxdb3.sh enterprise
```

The quick installer script is updated with each InfluxDB 3 Enterprise release, so it always installs the latest version.

#### Production deployment

For production deployments, use [Linux DEB or RPM](#linux-deb-or-rpm) for built-in systemd sandboxing, or [Docker](#pull-the-docker-image) with your own container security configuration.

For detailed security options, see [Manage security](/influxdb3/enterprise/admin/security/).

### Download and install the latest build artifacts

You can also download and install InfluxDB 3 Enterprise build artifacts directly:

[](#linux-binaries)

Linux binaries

-   [Linux | AMD64 (x86\_64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_linux_amd64.tar.gz) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_linux_amd64.tar.gz.sha256)
-   [Linux | ARM64 (AArch64) | GNU](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_linux_arm64.tar.gz) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_linux_arm64.tar.gz.sha256)

[](#macos-binaries)

macOS binaries

-   [macOS | Silicon (ARM64)](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_darwin_arm64.tar.gz) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2_darwin_arm64.tar.gz.sha256)

macOS Intel builds are coming soon.

[](#windows-binaries)

Windows binaries

-   [Windows (AMD64, x86\_64) binary](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2-windows_amd64.zip) • [sha256](https://dl.influxdata.com/influxdb/releases/influxdb3-enterprise-3.9.2-windows_amd64.zip.sha256)

### Pull the Docker image

Run the following command to pull the [`influxdb:3-enterprise` image](https://hub.docker.com/_/influxdb/tags?tag=3-enterprise&name=3-enterprise), available for x86\_64 (AMD64) and ARM64 architectures:

```bash
docker pull influxdb:3-enterprise
```

Docker automatically pulls the appropriate image for your system architecture.

[](#pull-for-a-specific-system-architecture)

Pull for a specific system architecture

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

```bash
# For x86_64/AMD64
docker pull \
--platform linux/amd64 \
influxdb:3-enterprise
```

```bash
# For ARM64
docker pull \
--platform linux/arm64 \
influxdb:3-enterprise
```

### Linux DEB or RPM

When installed via DEB or RPM on a `systemd`\-enabled system, InfluxDB 3 Enterprise runs in a sandboxed environment. The included `systemd` unit file configures the environment to provide security isolation for typical deployments. For more information, see [Manage security](/influxdb3/enterprise/admin/security/).

DEB and RPM installation is **recommended for non-Docker production deployments** due to built-in `systemd` sandboxing.

[](#deb-based-systems)

DEB-based systems

Use `apt-get` to install InfluxDB 3 Enterprise from the InfluxData repository:

```bash
curl --silent --location -O https://repos.influxdata.com/influxdata-archive.key
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 2>&1 \
| grep -q '^fpr:\+24C975CBA61A024EE1B631787C3D57159FC2F927:$' \
&& cat influxdata-archive.key \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/influxdata-archive.gpg > /dev/null \
&& echo 'deb [signed-by=/usr/share/keyrings/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main' \
| sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install influxdb3-enterprise
```

[](#rpm-based-systems)

RPM-based systems

Use `yum` to install InfluxDB 3 Enterprise from the InfluxData repository:

```bash
curl --silent --location -O https://repos.influxdata.com/influxdata-archive.key
test -d /usr/share/influxdata-archive-keyring/keyrings || sudo mkdir -p /usr/share/influxdata-archive-keyring/keyrings
gpg --show-keys --with-fingerprint --with-colons ./influxdata-archive.key 2>&1 \
| grep -q '^fpr:\+24C975CBA61A024EE1B631787C3D57159FC2F927:$' \
&& sudo cp ./influxdata-archive.key /usr/share/influxdata-archive-keyring/keyrings/influxdata-archive.asc \
&& cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = file:///usr/share/influxdata-archive-keyring/keyrings/influxdata-archive.asc
EOF
sudo yum install influxdb3-enterprise
```

#### TOML configuration (Linux)

After you install the DEB or RPM package, the InfluxDB 3 Enterprise TOML configuration file is located at `/etc/influxdb3/influxdb3-enterprise.conf` and contains the following settings:

-   [object-store](/influxdb3/enterprise/reference/config-options/#object-store): `file`
    
-   [data-dir](/influxdb3/enterprise/reference/config-options/#data-dir): `/var/lib/influxdb3/data`
    
-   [plugin-dir](/influxdb3/enterprise/reference/config-options/#plugin-dir): `/var/lib/influxdb3/plugins`
    
-   [node-id](/influxdb3/enterprise/reference/config-options/#node-id): `primary-node`
    
-   [cluster-id](/influxdb3/enterprise/reference/config-options/#cluster-id): `primary-cluster`
    
-   [mode](/influxdb3/enterprise/reference/config-options/#mode): `all`
    

#### License required

InfluxDB 3 Enterprise requires an active license to start. See how to [Activate a license](/influxdb3/enterprise/admin/license/#activate-a-license).

#### Run as a system service (Linux)

InfluxDB 3 Enterprise DEB and RPM installs include service files for running as a managed system service on Linux:

-   **systemd**: For modern Linux distributions
-   **SysV init**: For legacy system compatibility

##### Run using systemd

On `systemd` systems, the `influxdb3-enterprise` unit file is `enabled` on install, but the unit is not started in order to allow configuration.

###### Start, stop, and restart

The following examples use `sudo` for systems that require elevated privileges. On some systems (such as Amazon Linux or other RHEL-based distributions where you may already be running as root), you can omit `sudo` from the commands.

```bash
# Start the service
sudo systemctl start influxdb3-enterprise

# Stop the service
sudo systemctl stop influxdb3-enterprise

# Restart the service (use after configuration changes)
sudo systemctl restart influxdb3-enterprise
```

###### Check status and logs

```bash
# Check status (sudo to ensure full journal output)
sudo systemctl status influxdb3-enterprise

# Quick state checks (no sudo needed)
systemctl is-enabled influxdb3-enterprise
systemctl is-active  influxdb3-enterprise

# Recent logs
sudo journalctl --unit influxdb3-enterprise -n 200 --no-pager

# Follow logs
sudo journalctl --unit influxdb3-enterprise -f
```

###### Inspect the packaged unit

The packaged unit configures security sandboxing for typical deployments (see [Manage security](/influxdb3/enterprise/admin/security/)). To inspect the packaged unit and its resolved properties:

```bash
# Show the unit file
systemctl cat influxdb3-enterprise

# Show all resolved properties (paths, environment, sandboxing options)
systemctl show influxdb3-enterprise
```

###### Apply configuration changes

Edit the TOML configuration file and restart the service to apply changes:

```bash
sudoedit /etc/influxdb3/influxdb3-enterprise.conf
sudo systemctl restart influxdb3-enterprise
sudo systemctl status  influxdb3-enterprise
sudo journalctl --unit influxdb3-enterprise -n 100 --no-pager
```

`influxdb3 serve` does not support configuration reload; a restart is required after editing the TOML file or changing environment variables.

The TOML file is read by the systemd launcher and converted to `INFLUXDB3_*` environment variables before `influxdb3 serve` runs; CLI flags still override values from the TOML file. For details, see [TOML configuration files](/influxdb3/enterprise/reference/config-options/#toml-configuration-files).

##### Run using SysV

On SysV init systems, `influxdb3-enterprise` is disabled on install and can be enabled by adjusting `/etc/default/influxdb3-enterprise` to contain `ENABLED=yes`.

To start the database, enter the following commands:

```bash
# Start the database
/etc/init.d/influxdb3-enterprise start

# View status
/etc/init.d/influxdb3-enterprise status

# View logs
tail -f /var/lib/influxdb3/influxdb3-enterprise.log
```

### Verify the installation

After installing InfluxDB 3 Enterprise, enter the following command to verify that it installed successfully:

```bash
influxdb3 --version
```

If your system can’t locate `influxdb3` following a [quick install](#quick-install-for-linux-and-macos), `source` the configuration file (for example, `.bashrc`, `.zshrc`) for your shell–for example:

```zsh
source ~/.zshrc
```

For information about setting up a multi-node InfluxDB 3 Enterprise cluster, see [Create a multi-node cluster](/influxdb3/enterprise/get-started/multi-server/) in the Get started guide.

[Get started with InfluxDB 3 Enterprise](/influxdb3/enterprise/get-started/)

#### Related

-   [Upgrade InfluxDB 3 Enterprise](/influxdb3/enterprise/admin/upgrade/)

[install](/influxdb3/enterprise/tags/install/)