---
name: "upterm-session-stop"
section: "1"
platform: "linux"
package: "upterm"
version: "0.40.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/upterm-session-stop"
---

# 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)](/upterm-session/1.md)**

## HISTORY

27-Oct-2026 Auto generated by spf13/cobra