Skip to content

abiosoft/dockward

Repository files navigation

dockward

Port forwarding tool for Docker containers.

Demonstration

Typical Dockward use cases include:

  • Port forwarding to containers without published ports.
  • Port forwarding to containers based on a filter.
  • Testing stateless app scaled via docker-compose.

Requirements

Docker 1.10 and docker deamon running.

Installation

Homebrew (OSX only)

brew install dockward

Binary

Download binary for other platforms on the releases page or replace download link accordingly for OSX.

curl -LO https://github.com/abiosoft/dockward/releases/download/0.0.4/dockward_linux_amd64.tar.gz \
&& tar xvfz dockward_linux_amd64.tar.gz \
&& sudo mv dockward_linux_amd64 /usr/local/bin/dockward \
&& sudo chmod +x /usr/local/bin/dockward

Source

Requires Go.

go get -v -u github.com/abiosoft/dockward

Usage

Note: If dockward is not running on Linux or docker host, you will access it via docker host ip (e.g. dockermachine ip). Except --host mode.

Forward port 8080 to port 8080 in container amazing_leavitt.

dockward 8080 name=amazing_levitt

Forward port 8080 to port 80 in containers with label type=nginx.

dockward 8080 80 label=type=nginx

Forward port 8080 to a local port 3000.

dockward --host 8080 3000

Forward port 8080 to endpoints 127.0.0.1:3000 and 127.0.0.1:3001.

dockward --host 8080 127.0.0.1:3000 127.0.0.1:3001

For more.

dockward --help

Limitations

  • Dockward is intended for simple local development use cases. It may work for you outside of that.
  • Docker networks created are default settings i.e. bridge/overlay as the case may be. Nothing special.

Why the name ?

Naming is hard, you know.

DockerForward, port forwarding tool for docker containers.

License

Apache 2