Creating a Remote Jina Pod from Console

This tutorial guides you to run a Jina Pod remotely and communicate with it via console.

Before the start, make sure to read “Understanding Pea and Pod in Jina”.


  • Workflow: a set of connected pods for accomplishing certain task, e.g. indexing, searching, extracting.

  • Remote, local instance, local machine: the place where you want to run the pod, the place offers better computational capability or larger storage. For example, one may want to run an encode pod on the remote GPU instance.

  • Local, local instance, local machine: the place of your entrypoint and the rest parts of your workflow.


  • Both remote and local needs to have Jina installed.

  • The local needs to know the IP address/host name of the remote.

  • The ports on the remote (in the range of 49153-65535) must be public accessible.


1. Start a Pod on the Remote

To make the example as simple as possible, we do not equip any executor to the pod. In the remote console, type:

jina pod
▶️  /home/ubuntu/.local/bin/jina pod --uses _logforward
                         pod-role = None
                          polling = ANY
                        port-ctrl = 38059
                      port-expose = 47117
                          port-in = 39117
                         port-out = 50869
     [email protected][I]:input tcp:// (PULL_BIND) output tcp:// (PUSH_BIND) control over tcp:// (PAIR_BIND)
   [email protected][I]:post_init may take some time...
   [email protected][I]:post_init may take some time takes 0 seconds (0.00s)
   [email protected][S]:successfully built BaseExecutor from a yaml config
        [email protected][S]:ready and listening

After it reaches to ready and listening, the remote pod is ready to use. The port numbers are important for the local to connect to it. In this example we write down the port-ctrl=38059 for future reference. If you want to have fixed port numbers everytime, please use --port-in, --port-out, --port-ctrl to specify them. More information can be found jina pod documentation.

2. Test the Network Connectivity

Here we assume the remote is in the intranet and its IP address is

To verify the connectivity, we can use jina ping on the local.

In the local console:

jina ping 38059

If everything goes well, then you should be able to see something like:

[email protected][I]:ping tcp:// at 0 round takes 0.027 secs
[email protected][I]:ping tcp:// at 1 round takes 0.021 secs
[email protected][I]:ping tcp:// at 2 round takes 0.021 secs
[email protected][C]:avg. latency: 23 ms

Congratulations! You now have a remote Pod that can be connected.

Troubleshooting Checklist

  • [ ] Is the remote address correct?

  • [ ] Are the remote ports public accessible (e.g. Security Group on AWS, firewall blacklist)?

  • [ ] Is the remote address an internal IP address and not publicly accessible?

  • [ ] Is the local connected to internet?

  • [ ] Is remote Pod successfully started? You shall see a green highlighted ready and listening if it is successful.

If you have double checked the list and the problem is still not resolved, then consider to create an issue in our Github project page.

What’s next?

You many also want to check out the following articles. Using jina remotely with jinad