Skip to main content

Create SSH

To create an SSH tunnel between your endpoints, click on the Endpoints -> Create SSH button in the Portola Console. This will open a form where you can specify the details of the SSH tunnel you want to create.

  • Server Endpoint: The endpoint where you want the SSH service to run.
  • Auth Type: The authentication method you want to use for the SSH connection. You can choose between:
    • Password: Use a password for authentication. You will be able to use the username/password combination to SSH into the server endpoint. This account corresponts to the user account the Portola App is running as on the server endpoint.
    • Public Key: Use a public key for authentication. This is the recommended method for secure connections. A key pair is automatically generated by Portola App (on client side), and is stored under ~/.portola/ssh/ directory. You can use this private key to SSH into the server endpoint. The corresponding public key is automatically made available to the SSH server endpoint.
  • Client Endpoint: The endpoint where you want to access the SSH service from.
  • Client Port: The port on the client endpoint where the SSH service will be forwarded.

Once you fill in the details, click on the Create button to create the tunnel. The Portola Network will handle the rest, and you will see the new SSH tunnel listed in your endpoints. The tunnel will be active and ready to use immediately.

Using the SSH Tunnel​

Once the SSH tunnel is created, you can access it using any SSH client on the Client Endpoint (only). You can use the following details to connect:

# Note:
#   -i specifies the path to the private key file which is automatically generated by Portola App and stored under `~/.portola/ssh_keystore/ssh_host_key`.
#   client_port is the port you specified for the SSH service on the client endpoint.

ssh -p <client_port> -i ~/.portola/ssh_keystore/ssh_host_key localhost