Reference

upterm-session-stop(1)

Stop a running session

NAME

upterm-session-stop - Stop a running session

SYNOPSIS

upterm session stop NAME|ID [flags]

DESCRIPTION

Stop a running session, given its name or session ID.

NAME|ID is the session's name (the one 'upterm host' printed, or --name gave it) or its session ID; 'upterm session list' shows both.

The session's command is hung up, then terminated, then killed if it stays, and every attached terminal is released. The session's record keeps its outcome: 'upterm session info NAME' reports it as stopped.

A session that has already ended is reported as such and is not an error.

Exits 4 when no session has the name, and 1 for any other failure.

OPTIONS

-h, --help[=false]
help for stop

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false]
Enable debug logging (log file: /build/.upterm/upterm.log). A non-empty DEBUG turns it on too.

EXAMPLE

  # Stop the session named build-shell:
  upterm session stop build-shell
  # Stop a session given its session ID:
  upterm session stop d3k5fia7m4us73ehblug

SEE ALSO

upterm-session(1)

HISTORY

27-Oct-2026 Auto generated by spf13/cobra