Environment Variables#

You can use the environment variables listed below when running a job with custom commands.

Environment variables available for running jobs#

Variable

Value

Example

HORIZON_JOB_ID

The job’s ID.

a1b2c3d4e5f6

HORIZON_TEAM_ID

The ID of the team that owns the job.

f6e5d4c3b2a1

HORIZON_CASE_DIR

The Case Directory, which is the job’s storage path on the head node. Your commands start here.

/mnt/fs/files/my_case

HORIZON_FILES_DIR

The folder that storage paths are relative to.

/mnt/fs/files

HORIZON_STORAGE_DIR

Where the job’s storage is mounted.

/mnt/fs

HORIZON_APPS_DIR

Where applications are installed.

/mnt/fs/.cache/apps

HORIZON_INSTALL_DIR

Where the job’s application version is installed.

/mnt/fs/.cache/apps/converge/6.0.2

HORIZON_APP_VERSION

The application version the job runs.

6.0.2

HORIZON_MPI

The MPI implementation the application version uses (intelmpi or hpcx).

intelmpi

HORIZON_HOSTS_FILE

A file in the Case Directory that lists the private IP address of every node (one per line, head node first).

/mnt/fs/files/my_case/hosts

HORIZON_NODE_COUNT

The number of nodes.

2

HORIZON_CORES_PER_NODE

The number of cores per node the job is set to use. See Advanced Options > Cores per Node.

192

HORIZON_CORES_TOTAL

The number of cores per node times the number of nodes.

384

HORIZON_RDMA_DEVICE

For CONVERGE 6 and later versions, the RDMA device that connects the nodes. Empty when the nodes have none.

mlx5_2

HORIZON_RDMA_IFACE

For CONVERGE 6 and later versions, the network interface of the RDMA device. Empty when the nodes have none.

ens800f0np0

HORIZON_GTSUITE_DIR

Where GT-SUITE is installed for jobs running with GT-SUITE coupling. The default snippet runs CONVERGE on 2 fewer cores than HORIZON_CORES_TOTAL and leaves the remaining cores to GT-SUITE.

/mnt/fs/.cache/apps/gtsuite/2026.1.0000/gtsuite