nui

A terminal tool for executing into running Nomad allocations. Browse jobs and allocations through an interactive UI, or execute commands directly.

Installation

go install github.com/ssh-bastion/nui/cmd@latest

Environment Variables

export NOMAD_ADDR="http://localhost:4646"  # Required
export NOMAD_TOKEN="your-token"            # Required
export NOMAD_NAMESPACE="default"           # Optional
export NOMAD_REGION=""                     # Optional

Usage

Interactive UI Mode (Default)

Launch the UI to browse and execute into allocations:

./nui

1. Select a job from the filterable list
2. Choose an allocation and task
3. Enter the command to execute (default: sh)
4. The command runs in the selected allocation's container

Exit the UI with ESC.

Direct Execution Mode

Execute commands directly without the UI:

./nui alloc exec -task <task-name> <allocation-id> <command>

Examples:

# Execute sh in a nginx task
./nui alloc exec -task nginx abc123def456 sh

# Execute a specific command
./nui alloc exec -task nginx abc123def456 ls -la

If the task group has only one task, omit the -task flag:

./nui alloc exec abc123def456 sh