Skip to main content
Version: Next 🚧

How to use Port Forwarding​

This how-to demonstrates how to use port forwarding to access a running application.

Port forwarding can be started with the port-forward command:

epinio app port-forward samplejava 34506:8080

This will forward the traffic coming from localhost:34506 to the remote :8080. Note that specification of the local port is optional. When none is provided a random port will be selected.

Point to a specific instance​

Port forwarding can be directed to a specific instance of your app. To do this list all the instances of the application, pick the desired ID, and then use the --instance flag to direct the port forwarding to that instance:

-> % epinio app show samplejava

🚢 Show application details
Namespace: workspace
Application: samplejava

✔️  Details:
|        KEY           |                    VALUE                    |
|----------------------|---------------------------------------------|
| Origin               | /home/user/sample                           |
| Status               | 1/1                                         |
| Username             | admin                                       |
| StageId              | cac0d6fec92e0a1f                            |
| Age                  | 2m50s                                       |
| Active Routes        |                                             |
|                      | samplejava.172.19.0.4.omg.howdoi.website    |
| Desired Instances    |                                           1 |
| Bound Configurations |                                             |
| Environment          |                                             |

✔️  Instances: 
|            NAME             | READY |  MEMORY   | MILLICPUS | RESTARTS |  AGE  |
|-----------------------------|-------|-----------|-----------|----------|-------|
| samplejava-5f84c47f76-7mvv7 | true  | 214.0 MiB |         2 |        0 | 2m50s |
epinio app port-forward samplejava 34506:8080 --instance samplejava-5f84c47f76-7mvv7