Skip to main content
Version: v0.3.0

Deploy Infinity

This document provides guidance on deploying the Infinity database. In general, you can deploy Infinity in the following three ways:

Import Infinity as a Python module

IMPORTANT

This approach allows you to embed Infinity as a module in a Python application. To deploy Infinity with the client and server as separate processes, follow the instructions in Deploy Infinity using Docker or Deploy Infinity using binary.

Prerequisites

  • CPU: x86_64 with AVX2
  • Python: Python 3.10+
  • OS:
    • Linux with glibc ≥ 2.17
    • Windows 10+ with WSL/WSL2

Install Infinity as a module

pip install infinity-sdk==0.3.0

Create an Infinity object

import infinity

infinity_obj = infinity.connect("/path/to/save/to")
note

For detailed information about the Python API, see the Python API Reference.

Deploy Infinity using Docker

To deploy Infinity with the client and server as separate processes, consider either Deploy Infinity using Docker or Deploy Infinity using binary. Be aware of the respective system requirements for each approach.

Prerequisites

  • CPU: x86_64 with AVX2
  • OS:
    • Linux with glibc ≥ 2.17,
    • Windows 10+ with WSL/WSL2,
    • MacOS

Install Infinity server

This section provides instructions on deploying the Infinity using Docker on Linux x86_64, MacOS x86_64, and Windows WSL/WSL2.

sudo mkdir -p /var/infinity && sudo chown -R $USER /var/infinity
docker pull infiniflow/infinity:nightly
docker run -d --name infinity -v /var/infinity/:/var/infinity --ulimit nofile=500000:500000 --network=host infiniflow/infinity:nightly -f /var/infinity/infinity_conf.toml

Install Infinity client

pip install infinity-sdk==0.3.0

Connect to Infinity Server

import infinity

infinity_obj = infinity.connect(infinity.NetworkAddress("<SERVER_IP_ADDRESS>", 23817))
note

For detailed information about the Python API, see the Python API Reference.

Deploy Infinity using binary

To deploy Infinity with the client and server as separate processes, consider either Deploy Infinity using binary or Deploy Infinity using Docker. Be aware of the respective system requirements for each approach.

Prerequisites

  • CPU: x86_64 with AVX2
  • OS:
    • Linux with glibc ≥ 2.17
    • Windows 10+ with WSL/WSL2

Install Infinity server

This section provides instructions on deploying Infinity using binary package on Linux x86_64. You can download the binary package (deb, rpm, or tgz) for your Linux system from https://github.com/infiniflow/infinity/releases. The prebuilt packages are compatible with Linux distributions based on glibc 2.17 or later, for example, RHEL 7, Debian 8, Ubuntu 14.04.

Fedora/RHEL/CentOS/OpenSUSE

sudo rpm -i infinity-0.3.0-x86_64.rpm
sudo systemctl start infinity

Install Infinity client

pip install infinity-sdk==0.3.0

Connect to Infinity Server

import infinity

infinity_obj = infinity.connect(infinity.NetworkAddress("<SERVER_IP_ADDRESS>", 23817))
note

For detailed information about the Python API, see the Python API Reference.