A full documentation of FlexSearch is available here: https://github.com/nextapps-de/flexsearch

Installation

npm install flexsearch-server

Run setup once when not installing via "npm install":

npm run setup

Run as a single web server:

npm start

Run as a server cluster:

npm run cluster

Run with a specified environment:

npm start production

npm run cluster test

The server is listening at:

The default port for production is 6780 (over HTTP) and 6781 (over HTTPS), you can change the default ports in the configs.

When NODE_ENV is set, all manual passed environments will be overridden.

API Overview

RESTful

JSON

Server Environment Variables

Configuration

When you do not pass any custom options, the environment will be inherited from NODE_ENV by default.

Override the current environment (NODE_ENV) by adding a field in the root of package.json:

  "flexsearch": "production" // development, test

Or add a config payload in the root of package.json:

The field "client" holds the flexsearch options

  "flexsearch": {
    "server": {
      "debug": true,
      "port": 80,
      "port_ssl": 443,
      "force_ssl": false,
      "https": true,
      "compress": true,
      "autosave": 2000,
      "worker": "auto"
    },
    "client": {
      "async": false,
      "cache": 0,
      "worker": 4
    }
  }

Or provide a config json file for each environment respectively and pass file locations:

You can also provide a config json file to override the default settings globally.

  "flexsearch": {
    "development": "config/development.json",
    "production": "config/production.json",
    "test": "config/test",
    "default": "config/default.json"
}

Or just provide a flexsearch.json in the root of your project.

Persistence

Turn on persistence by setting a numeric value as delay on config.autosave. Flexsearch will automatically save the index to the local filesystem and also loads it when starting.

Disable persistence by setting this field to false.

Setup SSL for HTTPS Connections

Inside the folder cert add the certificate as a .crt file and the key as a .pem file for each environment respectively.

Development Environment:

cert/development.crt cert/development.pem

Production Environment:

cert/production.crt cert/production.pem

Important Notes

You can increase workers without any drawbacks, but when you decrease worker count, the old index doesnt restore completely from the filesystem. This will be fixed in an upcoming version. As long please do not decrease worker count when using persistent index.

Cluster

FlexSearch Server actually use Node.js Clusters and a Connection Pool to balance all incoming load through the workers.

Copyright 2019 Nextapps GmbH Released under the Apache 2.0 License