Skip to content

Settings Basics

NEX uses environment-style configuration files. Two locations are supported:

  1. Local .env file (recommended for server or manual installations): A .env file placed in the same directory as the NEX binary allows administrators to define default settings for the installation. These settings apply to all users running that binary.

  2. User configuration file: Individual users can create a personal configuration file located at: 

    ~/.nex/config
    This file allows users to override or extend the default configuration with their own settings.

Note

When both files exist, user configuration takes precedence, allowing personal overrides without modifying the system-level .env file.

Before running NEX for the first time, you need to create the ~/.nex directory and the config file with:

mkdir -p ~/.nex
touch ~/.nex/config

The configuration files use a standard environment variable format, where each setting is defined as a key-value pair:

VARIABLE=value

After modifying the configuration, simply restart NEX for the changes to take effect.

Info

Some settings are mutually exclusive (for example, only one LLM_PROVIDER can be active at a time). Keep your config to a single active provider block to avoid ambiguity.