Ignite Summit 2025 — Watch on demand 

Apache Ignite logo
Edit

Installing Using ZIP Archive

Prerequisites

JDK

11 and later

OS

Linux (Ubuntu 20.04), Windows (10 Home), macOS

Ignite Package Structure

The Ignite provides 2 archives for the distribution:

  • ignite3-db-3.0.0 - this archive contains everything related to the Ignite database, and when unpacked, the folder where data will be stored by default. You start Ignite nodes from this folder.

  • ignite3-cli-3.0.0 - this archive contains the Ignite CLI tool. This tool is the main way of interacting with Ignite clusters and nodes.

Installing Ignite Database

To install the Ignite database, download the database archive from the website and then:

  1. Unpack the archive:

    unzip ignite3-db-3.0.0.zip && cd ignite3-db-3.0.0
    Expand-Archive ignite3-3.0.0.zip -DestinationPath . ; cd ignite3-db-3.0.0
    unzip -xf ignite3-db-3.0.0.zip & cd ignite3-db-3.0.0

  2. Create the IGNITE_HOME environment variable with the path to the ignite3-db-3.0.0 folder.

Starting the Node

Once you have unpacked the archive, you can start the Ignite node:

bin/ignite3db

By default, the node loads the etc/ignite-config.conf configuration file on startup. You can update it to customize the node configuration, or change the configuration folder in the etc/vars.env file.

When the node is started, it will enter the cluster if it is already configured and initialized, or will wait for cluster initialization.

Installing Ignite CLI Tool

The CLI tool is the primary means of working with the Ignite database. It is not necessary to install on every machine that is running Ignite, as you can connect to the node via REST interface.

To install the Ignite CLI, download the database archive from the website and then unpack it:

unzip ignite3-cli-3.0.0.zip && cd ignite3-cli-3.0.0
Expand-Archive ignite3-cli-3.0.0.zip -DestinationPath . ; cd ignite3-cli-3.0.0
unzip -xf ignite3-cli-3.0.0.zip & cd ignite3-cli-3.0.0

Next Steps

With the Ignite installed, you can proceed with the Getting Started or use the available APIs immediately.

© 2025 The Apache Software Foundation.
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.