52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# Shell
|
|
|
|
A login shell on the server, as your console account: your own POSIX account of the directory, or
|
|
a local account root chose.
|
|
|
|
- **Opening** asks for your password and code again, unless you used a shell within the server's
|
|
`web.shell_auth_timeout` minutes. **Open with a passkey** takes one of your passkeys instead,
|
|
unlocked with your device's PIN or biometrics; it shows when you have a passkey (see
|
|
[Account](account.md)).
|
|
- **Closing:** the server ends the shell after `web.shell_idle_minutes` without a keystroke; the
|
|
page shows the reason and keeps the terminal readable.
|
|
|
|
## Editor
|
|
|
|
`lme FILE...` (or `linux-manager-editor FILE...`) in the shell opens the files in the editor of this
|
|
page and returns at once:
|
|
|
|
```sh
|
|
lme /etc/hosts ~/notes.txt
|
|
```
|
|
|
|
- **Tabs:** each file has a tab with its name, and its path as the tooltip. A dot marks unsaved
|
|
changes, and the cross closes the tab, asking first when there are unsaved changes.
|
|
- **Editor icon** (left of the shell icon): shown while a file is open. It switches between the
|
|
terminal and the editor; the shell keeps running.
|
|
- **Minimap button** (left of Save): shows or hides the minimap at the right edge of the editor.
|
|
This browser remembers the choice.
|
|
- **Save** (or Ctrl+S): writes the file on the server, as your console account. When the file
|
|
changed on the server after it was read, **Reload** takes the server's version and **Overwrite**
|
|
writes yours.
|
|
- **Limits:** text files of up to 1 MiB, at most 20 at a time. A file that does not exist is
|
|
created when saved. A file your console account may not write cannot be saved; edit it in the
|
|
terminal.
|
|
- **When files close:** when the shell ends, every file closes and the icon goes away. `lme`
|
|
works only in this shell.
|
|
|
|
## Requirements
|
|
|
|
- Membership of `admins`, enrolment for one-time passwords (see [Account](account.md)), also when
|
|
you open the shell with a passkey, as the server's login session and `sudo` need it, and console
|
|
login, which root switches on the server:
|
|
|
|
```sh
|
|
linux-manager-user console <name> --posix
|
|
```
|
|
|
|
- The server offers the shell only while its `web.shell` is `true`:
|
|
|
|
```sh
|
|
linux-manager-config-edit set web.shell true
|
|
```
|