Linux terminal and console

Reach a Linux computer's command line or text console, with or without a desktop.

The headless service (Humble 0.11 and newer, Linux only) makes a Linux computer reachable without a desktop: a server, a computer with no monitor, or one whose desktop nobody is signed in to. It appears in your server account as a computer of its own, named <computer> (terminal) or <computer> (console), with an icon in the dashboard and the app's Computers list that says what connecting opens. On a computer with a desktop it runs next to the background service. The app's Computers list then shows the computer on one line, with a >_ button between Connect and the files button that opens its terminal (both services must run Humble Viewer 0.12 or newer); the dashboard lists them as two entries.

ModeConnecting opensRuns as
Terminal (the default)A shell, as with SSH: a command line on that computer, in a terminal in the session window.The account you choose. The shell is that account's; sudo still asks for its password.
ConsoleThe computer's text console, as its screen shows it (the login prompt, boot messages), typed into with your keyboard. Sign in at its login prompt as you would at the computer.root, without any of root's special powers (no capabilities, a read-only system, only the console and keyboard devices).

Set it up

Install Humble's package (see Install the app), then turn the service on for the account whose shell the terminal should give:

sudo humble headless setup --user alice          # terminal mode, alice's shell
sudo humble headless setup --mode console        # or: the text console

Without --user it uses the account that ran sudo. It refuses to give root shells unless you add --allow-root. Then add it to your server account, as that account (or with sudo for console mode):

sudo -u alice humble --headless-service login https://remote.example.com USERNAME
sudo -u alice humble --headless-service add-this-computer

or enroll it with a code from the dashboard's Deploy page: sudo -u alice humble --headless-service enroll CODE. Check it with humble --headless-service status, the same way: it shows the service's own ID and one-time password, which work for direct connections too (port 21422).

sudo humble headless remove stops and disables it. Its identity stays in /var/lib/humble-headless, so setting it up again brings back the same computer.

Connect

Security notes