Skip to content

Installation

Using Docker

The recommended way to run Nexo Search is using Docker.

bash
# Pull the image
docker pull searchlabs/nexo:0.0.4

# Run the container
docker run -d \
  --name nexo \
  -p 9000:80 \
  docker.io/searchlabs/nexo:v0.0.4

# Nexo Configuration Guide

Environment Variables

The following environment variables can be used to configure the Nexo service:

VariableDescriptionDefault
NEXO__SERVICE__HTTP_ADDRESSHTTP server address0.0.0.0:8200
NEXO__SERVICE__MAX_REQUEST_SIZE_MBMaximum request size in MB32
NEXO__STORAGE__PATHData storage path/data
NEXO__LOGGING__LEVELLog levelinfo

Quick Start

To run Nexo with default configuration:

bash
docker run -d \
  --name nexo \
  -p 9000:80 \
  -e NEXO__STORAGE__PATH="/data" \
  -e NEXO__LOGGING__LEVEL="Debug" \
  docker.io/searchlabs/nexo:v0.0.4

Configuration Details

HTTP Server

  • NEXO__SERVICE__HTTP_ADDRESS: Defines the interface and port the server listens on
  • NEXO__SERVICE__MAX_REQUEST_SIZE_MB: Limits the maximum size of incoming requests

Storage

  • NEXO__STORAGE__PATH: Specifies where Nexo stores its data

Logging

  • NEXO__LOGGING__LEVEL: Sets the logging verbosity (available options: debug, info, warn, error)

Verifying Installation

bash
# Check if the server is running
curl http://localhost:9000

# Expected response
{
  "nexo": {
    "name": "nexo",
    "tagline": "Next Generation Search Infrastructure",
    "version": "v0.0.3"
  },
  "tantivy": {
    "version": "v0.22.0",
    "index_version": 6,
    "min_supported_index_version": 4
  }
}