Skip to content

Environment Variables

RafaelGoulartB edited this page Nov 1, 2026 · 1 revision

Environment Variables

The HERONITE_* switches are on when set to anything except empty or 0.

Folders

Variable What it does
HERONITE_DATA_DIR=<folder> Use another data folder. Config and cache then go next to it, in <folder>.heronite/. Handy for a second, separate Collection.
HERONITE_LOG_DIR=<folder> Write logs to another folder
HERONITE_STEAM_DIR=<folder> Where Steam is, when Heronite does not find it

Turning things off

Variable What it does
HERONITE_NO_UPDATE_CHECK No automatic update checks
HERONITE_NO_TRAY No tray icon
HERONITE_NO_GAMEPAD No controller input in console mode
HERONITE_NO_ANIMATIONS No animations
HERONITE_NO_SINGLE_INSTANCE Allow more than one Heronite at a time
HERONITE_NO_ONBOARDING Skip the first-run setup
HERONITE_DISABLE_IDLE_JOBS No background work while idle
HERONITE_DISABLE_TOOLS_UPDATE Do not refresh DXVK, Winetricks, and umu in the background
HERONITE_WINE_OFFLINE No network for the Wine Manager (Linux)

Store tools

Variable What it does
HERONITE_LEGENDARY_BIN=<path> Use this legendary instead of the downloaded one
HERONITE_GOGDL_BIN=<path> Use this gogdl
HERONITE_NILE_BIN=<path> Use this nile

Logs

Variable What it does
RUST_LOG=debug More detail in the log (trace for everything)

Variables Heronite sets

Scripts that run before or after a game, and programs that run alongside it, get these:

Variable Value
HERONITE_GAME_TITLE The game's name
HERONITE_GAME_APP_NAME Its id
HERONITE_GAME_RUNNER Its store (legendary, gog, nile, sideload, …)
HERONITE_GAME_PLATFORM Its platform
HERONITE_GAME_EXEC The program that runs
HERONITE_GAME_PREFIX Its Wine prefix (Linux)
HERONITE_GAME_SCRIPT_TYPE Which script this is (before or after)

The same values are also set as HEROIC_GAME_*, so scripts written for Heroic keep working.

Inside the sandbox, HERONITE_SANDBOX is set.

Clone this wiki locally