Configure SSH on TurboStack

How to authorize SSH keys, set the SSH port, and control password authentication for a host on TurboStack, with host-level YAML keys and an example.

Authorize keys and set the SSH options for a host so your team can open shell and SSH File Transfer Protocol (SFTP) sessions securely.

The SSH tab of a host, with the SSH key list, the Add SSH Key button and the option to allow SSH authentication by keys only
The SSH tab of a host, with the SSH key list, the Add SSH Key button and the option to allow SSH authentication by keys only

Where to configure it

SSH is configured at the host level:

  1. Open the host.
  2. Go to the SSH tab.
  3. Add authorized public keys and adjust the port and password-authentication options.

Keys set at the group level are inherited by member hosts.

YAML configuration

Required

Key Meaning
ssh_keys List of authorized public keys allowed to open SSH/SFTP sessions as every system user on the host.
system_users[].ssh_keys List of public keys that may open sessions as that one system user only. Set on the SSH tab with Only specific accounts.

Optional

Key Meaning
ssh_port The TCP port SSH listens on.
ssh_passwords Whether to allow password authentication. Recommended: keep disabled (false).
# Host-level: authorized keys, custom port, key-only auth
ssh_keys:
  - "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... alice@example.com"   # every account
ssh_port: 22
ssh_passwords: false
system_users:
  - username: shop
    ssh_keys:
      - "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... agency@example.com"   # the shop account only