Skip to content

SSH & Remote Connections

Null Terminal acts as a first-class SSH client, wrapping standard SSH connections in its rich TUI environment.

✨ Features

  • Saved Hosts: Manage frequently accessed servers.
  • Identity Management: Automatic key forwarding.
  • TUI-over-SSH: Run remote interactive apps (vim, htop) seamlessly.

🖥️ Managing Hosts

Adding a Host

  1. Type /ssh add to open the Host Manager.
  2. Enter the connection details:
  3. Hostname/IP: e.g., 192.168.1.50 or myserver.com
  4. User: e.g., root or ubuntu
  5. Port: default 22
  6. Alias: A friendly name (e.g., "Production DB")

Connecting

You can connect in two ways:

  1. Directly via Command:

    /ssh <alias>
    # or
    /ssh user@host
    

  2. Via Command Palette:

  3. Press Ctrl+P.
  4. Select "SSH: Connect to Host".
  5. Choose from your list of saved hosts.

🔒 Key Management

Null Terminal uses your system's SSH keys (~/.ssh/id_rsa, etc.) by default. Ensure your public key is added to the remote server's ~/.ssh/authorized_keys.

🛠️ Deployment via SSH

You can use the /agent to perform tasks on remote servers if you have SSH access configured. The agent can pipe commands over the SSH connection (feature in beta).