Skip to content

Paths

The 10x Engine loads files from two directory types:

Directory Contents Example
Modules Pipeline, module, and app definitions shipped with the engine pipelines/run/modules/input/
Config User configuration that customizes behavior config/log4j2.yaml

This separation (similar to Helm charts vs. values files) allows engine updates without overwriting user configuration.

Path Resolution

The engine searches for these directories using the following resolution order:

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#101519', 'primaryTextColor': '#fff', 'primaryBorderColor': '#272d33', 'lineColor': '#4ade80', 'background': '#01080f'}}}%%
flowchart LR
    START(("🚀"))
    INCLUDE["TENX_INCLUDE_PATHS"]
    MODULES["TENX_MODULES"]
    CONFIG["TENX_CONFIG"]
    HOME["TENX_HOME"]
    WORKDIR["Working Directory"]
    OSDEFAULT["OS Defaults"]
    DONE(("✓"))

    START --> INCLUDE
    INCLUDE -->|set| DONE
    INCLUDE -->|not set| MODULES
    MODULES --> CONFIG
    CONFIG -->|both set| DONE
    CONFIG -->|missing| HOME
    HOME -->|found| DONE
    HOME -->|not set| WORKDIR
    WORKDIR -->|"pipelines/ found"| DONE
    WORKDIR -->|not found| OSDEFAULT
    OSDEFAULT --> DONE

    classDef default fill:#101519,stroke:#272d33,color:#fff,stroke-width:1px,rx:8,ry:8
    classDef override fill:#06b6d4,stroke:#0891b2,color:#fff,stroke-width:2px
    classDef envvar fill:#6366f1,stroke:#4f46e5,color:#fff,stroke-width:2px
    classDef home fill:#10b981,stroke:#059669,color:#fff,stroke-width:2px
    classDef workdir fill:#f59e0b,stroke:#d97706,color:#000,stroke-width:2px
    classDef osdefault fill:#8b5cf6,stroke:#7c3aed,color:#fff,stroke-width:2px
    classDef endpoint fill:#059669,stroke:#047857,color:#fff,stroke-width:2px

    class INCLUDE override
    class MODULES,CONFIG envvar
    class HOME home
    class WORKDIR workdir
    class OSDEFAULT osdefault
    class START,DONE endpoint

Locations are checked in order of priority (first match wins):

Source Description
TENX_INCLUDE_PATHS Explicit semicolon-separated list of paths - overrides all other resolution
TENX_MODULES + TENX_CONFIG Checked independently: modules for $TENX_MODULES/pipelines + $TENX_MODULES/apps, config for $TENX_CONFIG/pipelines. If either is missing, continue to next priority
TENX_HOME Checks for modules at $TENX_HOME/lib/app/modules or $TENX_HOME/modules/, and config at $TENX_HOME/config/
Working Directory Checks for modules at $PWD/pipelines/ or $PWD/modules/, and config at $PWD/config/
OS Defaults Checked in order (first match wins):
Linux:
modules: /opt/tenx-edge/lib/app/modules or /opt/tenx-cloud/lib/app/modules
config: /etc/tenx/config
Windows:
modules: %ProgramFiles%\TenX\lib\app\modules or %LOCALAPPDATA%\TenX\lib\app\modules
config: %ProgramData%\TenX\config or %LOCALAPPDATA%\TenX\config

Log File Location

For complete logging documentation including log file location, configuration, custom plugins, and debugging techniques, see the Engine Logging page.