Tunnel

Definition

A tunnel is a temporary private route that lets Rima’s cloud browser reach an application running on your computer or private network.

What it is for

Use a tunnel when you want cloud execution or a schedule to test an app that has no public internet address.

How it works

• Start the tunnel from the local-runner workflow; it opens a private route from Rima’s cloud to a port on your machine.
• Your personal tunnel address is shown on the dashboard; use it as the test target so a cloud run or schedule reaches the local app.
• Traffic flows only while the local tunnel process is running; stop the process and the route closes.

Example

Start a tunnel to localhost:3000, use the generated Rima tunnel address as the test target, and run the cloud test against your local build.

Common use cases

• Run a cloud browser against localhost.
• Test a VPN-only staging app.
• Share a temporary preview with a scheduled test.
• Debug a private service without deploying it publicly.

Where to find it

Use the personal tunnel address shown on the dashboard and the tunnel command in the local-runner workflow. Keep the local tunnel process running for as long as the cloud run needs access.

Limitations, requirements, and permissions

• The tunnel process must stay running for the whole cloud run or scheduled window.
• The tunnel address is personal, so treat it like private infrastructure.
• When everything can run on your own machine, the local runner itself may be simpler than tunneling.

Related features and guides

• Local runner and CLI
• Local runner and CLI
• URL rewriting