:orphan: .. include:: /_includes/all.rst .. _howto_ssh_port_forward_on_host_to_docker_toolbox: ****************************************** SSH port-forward on host to Docker Toolbox ****************************************** .. note:: This is a **Remote SSH port-forward** (``ssh -R``) **Table of Contents** .. contents:: :local: Requirements ============ You shell must have an **SSH client** (the ``ssh`` command or equivalent). .. seealso:: * :ref:`howto_open_terminal_on_mac` * :ref:`howto_open_terminal_on_win` * :ref:`howto_find_docker_toolbox_ip_address` * :ref:`howto_ssh_into_docker_toolbox` * |ext_lnk_ssh_tunnelling_for_fun_and_profit| Overview ======== This is a **remote** SSH port-forward (``ssh -R``). In other words, the host os will make the port **remotely availabl** on the Docker Toolbox machine. Therefore the process must be initiated on the host os. General command --------------- The following represents the general structure of a remote ssh port-forward: .. code-block:: bash ssh -R :: @ +------------------------------+-----------------------------------------------------------------------------+ | ```` | The port on the Docker Toolbox machine the service should be made available | +------------------------------+-----------------------------------------------------------------------------+ | ```` | The IP address on the host os, where the service is currently listening | +------------------------------+-----------------------------------------------------------------------------+ | ```` | The port on the host os, where the service is bound to | +------------------------------+-----------------------------------------------------------------------------+ | ```` | The username of the host os SSH server for the connection | +------------------------------+-----------------------------------------------------------------------------+ | ```` | The IP address of the host at which the SSH server is reachable | +------------------------------+-----------------------------------------------------------------------------+ Command example --------------- Making ``127.0.0.1:10000`` from host os available on ``0.0.0.0:8080`` on Docker Toolbox machine: .. code-block:: bash ssh -R 8080:127.0.0.1:10000 docker@192.168.99.100 +--------------------------+-----------------------------------------------------------------------------+ | ``8080`` | Docker Toolbox should make the port available on itself on this port | +--------------------------+-----------------------------------------------------------------------------+ | ``127.0.0.1`` | The service currently listens on that IP address on the host os | +--------------------------+-----------------------------------------------------------------------------+ | ``10000`` | The service is currently bound to that port on the host os | +--------------------------+-----------------------------------------------------------------------------+ | ``docker`` | The username of the Docker Toolbox SSH server for the connection | +--------------------------+-----------------------------------------------------------------------------+ | ``192.168.99.100`` | The IP address of the Docker Toolbox at which the SSH server is reachable | +--------------------------+-----------------------------------------------------------------------------+ Examples ======== For this example we assume the following information: * Docker Toolbox IP address is ``192.168.99.100`` * Docker Toolbox SSH username is ``docker`` Make host-based MySQL available on Docker Toolbox ------------------------------------------------- 1. Open a terminal on your host os 2. Forward: ``127.0.0.1:3306`` from host os to ``0.0.0.0:3306`` on Docker Toolbox .. code-block:: bash toolbox> ssh -R 3306:127.0.0.1:3306 docker@192.168.99.100 Make host-based PgSQL available on Docker Toolbox ------------------------------------------------- 1. Open a terminal on your host os 2. Forward: ``127.0.0.1:5432`` from host os to ``0.0.0.0:5432`` on Docker Toolbox .. code-block:: bash toolbox> ssh -R 5432:127.0.0.1:5432 docker@192.168.99.100