Skip to content

Connect to an SSH server

Publish an SSH service with a TCP tunnel, then connect through a local caller port.

The publisher machine must reach an SSH server on 127.0.0.1:22. On the caller machine, install Node.js 26.7 or later and an SSH client. You need valid credentials for the SSH server.

1. Publish the SSH service

On the machine that can reach the server:

npx tubu-cli tcp 22 --domain my-ssh.tubu.dev

For a different target, replace 22 with a URL such as tcp://192.168.1.20:22. Wait for Tunnel ready: and keep the publisher running.

2. Start the caller listener

On the machine where you will run SSH:

npx tubu-cli forward 2222 -d my-ssh.tubu.dev

No Tubu API key is required for forward. Wait for Listening:.

3. Connect and verify

In another terminal on the caller machine, replace alice with your SSH user:

ssh -p 2222 alice@127.0.0.1

Verify the SSH host key, then authenticate. Expect a session on the target.

For connection or port errors, see the FAQ.