Skip to content

Commit b38282d

Browse files
authored
📝 Document clipboard copy and paste in the Web Terminal (#1073)
1 parent 831ee9f commit b38282d

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

ssh/DOCS.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,20 @@ Customize your shell environment even more with the `init_commands` option.
225225
Add one or more shell commands to the list, and they will be executed every
226226
single time this app starts.
227227

228+
## Clipboard: copying and pasting
229+
230+
The Web Terminal is based on xterm.js, which follows X11-style clipboard
231+
conventions that may differ from what you expect:
232+
233+
- **Copy**: hold `Shift` and select the text with your mouse. The selection is
234+
copied to your system clipboard right away (a small scissors icon briefly
235+
pops up). There is no need to press `Ctrl+C`.
236+
- **Paste**: press `Ctrl+Shift+V`, or right-click and choose paste, depending
237+
on your browser.
238+
239+
This applies to the Web Terminal in the Home Assistant frontend. A regular SSH
240+
client uses the clipboard behavior of its own terminal instead.
241+
228242
## Known issues and limitations
229243

230244
- When SFTP is enabled, the username MUST be set to `root`.

0 commit comments

Comments
 (0)