# Using Pinggy with Docker

> Pinggy provides pre-built docker images for easily creating tunnels. It can be used to create UDP tunnels as well.
> Source: https://pinggy.io/docs/docker/


# Using Pinggy with Docker

Pinggy provides pre-built Docker images for easily creating tunnels. It can be used to create HTTP(S), TCP, UDP, and TLS tunnels. The only requirement is to have Docker installed.

Here is an example for starting a HTTP tunnel on port `8080` on localhost:



#### Linux

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run --net<span class="o">=</span>host -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 free.pinggy.io
</span></span></code></pre></div>

#### Mac

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 free.pinggy.io
</span></span></code></pre></div>

#### Windows

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 free.pinggy.io
</span></span></code></pre></div>



> Note: In linux we need to pass `--net=host` option to make docker use the same network as the host. For Mac and Windows, we need not pass this option. Instead, internally we replace `localhost` or `127.0.0.1` to `host.docker.internal`. This forwards the traffic to the host.

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; background: #000;">
  <iframe 
    src="https://www.youtube.com/embed/0C_k9_OOcwQ?si=-fsX9sYdn_lx50aw" 
    title="Pinggy with docker video player" 
    frameborder="0" 
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
    referrerpolicy="strict-origin-when-cross-origin" 
    allowfullscreen 
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
  ></iframe>
</div>


## Using Web Debugger

To enable the Web Debugger, you need to pass the option `-L0.0.0.0:4300:localhost:4300`. You can change the local port to any port you want as: `-L0.0.0.0:<port>:localhost:4300`. In case of Mac or Windows, you need to map the port also.


#### Linux

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run --net<span class="o">=</span>host -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 -L4300:localhost:4300 free.pinggy.io
</span></span></code></pre></div>

#### Mac

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -p 4300:4300 -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 -L0.0.0.0:4300:localhost:4300 free.pinggy.io
</span></span></code></pre></div>

#### Windows

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -p 4300:4300 -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 -L0.0.0.0:4300:localhost:4300 free.pinggy.io
</span></span></code></pre></div>



You can access the web debugger from your browser by visiting: <a href="http://localhost:4300" target="_blank" >http://localhost:4300</a>

## UDP Tunnels

A major advantage of using Pinggy through docker is the ability to create UDP tunnels. Here is an example of a UDP tunnel to port `8000`:



#### Linux

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run --net<span class="o">=</span>host -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 udp@free.pinggy.io
</span></span></code></pre></div>

#### Mac

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 udp@free.pinggy.io
</span></span></code></pre></div>

#### Windows

<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker run -it pinggy/pinggy -p <span class="m">443</span> -R0:localhost:8080 udp@free.pinggy.io
</span></span></code></pre></div>




## Customizing your tunnel

Any Pinggy configuration will work with the docker container. To learn about more options see [Pinggy CLI](/docs/cli/) documentation.

You can log in to <a href="https://dashboard.pinggy.io/" target="_blank" >https://dashboard.pinggy.io/</a> and use the tunnel command configuration tool. You just need to make some tweaks to that command to make it work with docker.

For Linux, add `--net=host` option.

And for the Web Debugger to work in Windows and Mac, make sure to pass `-L0.0.0.0:4300:localhost:4300` instead of `-L4300:localhost:4300`, along with the port mapping `-p 4300:4300`.