Create an SSH Tunnel to a Node with PuTTY

If a resource provided by an Oracle Java Cloud Service node uses a port that is not directly accessible through the Internet, you can access that resource by creating a secure shell (SSH) tunnel to the port. You can create an SSH tunnel from a Windows platform by using PuTTY, an open source networking client.

In general, an SSH tunnel can map a remote port to any available port number on your local computer. Some protocols, such as Java Remote Method Invocation (RMI), require that the remote and local port numbers be the same value.

To download PuTTY, go to

  1. Access your service console.
  2. Click the name of the service instance that contains the node that you want to access.
  3. On the Overview page, identify the Public IP address of the node that you want to access.
    For example,
  4. Start PuTTY on your Windows computer.
    The PuTTY Configuration window is displayed, showing the Session panel.
  5. In the Host Name (or IP address) field, enter the public IP address of the node.
  6. In the Category navigation tree, expand Connection, and then click Data.
  7. In the Auto-login username field, enter opc.
  8. In the When username is not specified field, select Prompt.
  9. In the Category tree, expand Connection, and then click SSH.
  10. Under Protocol options, select the check box Don't start a shell command at all.
  11. In the Category tree, expand SSH, and then click Auth.
  12. Under Private key file for authentication, click Browse.
  13. Navigate to the location of your private key file, and select it. Click Open.
    This private key corresponds to the public key that you specified when you created this service instance.


    The .ppk file extension indicates that the private key is in PuTTY's proprietary format. You must use a key of this format when using PuTTY. If Oracle Cloud generated this key for your service instance, see the PuTTY documentation for information about converting the key format.
  14. In the Category tree, expand SSH, and then click Tunnels.
  15. In the Destination field, enter IP:port,
    where IP is the IP address of the node and port is the port number on the node to which you want to connect.
  16. In the Source Port field, enter the same port number.
  17. Click the Add button.
  18. Optional: To save this session configuration, click Session in the Category tree, and then click Save.
    To load a saved configuration, select the configuration name, and then click Load.
  19. Click Open.
  20. If prompted, enter the passphrase for the private key.

Applications that are running on your local computer can now communicate with the node by using localhost:port, where port is the local port number.

After your work with the SSH tunnel is completed, press Ctrl+C to close the SSH tunnel.