Skip to content
Port forwarding tool for Docker containers
Go Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
balancer Gofmt. Docs update. Mar 1, 2016
cli upate library, vendor deps Apr 16, 2018
network upate library, vendor deps Apr 16, 2018
util
vendor upate library, vendor deps Apr 16, 2018
.gitignore
LICENSE Modified license Feb 29, 2016
README.md
buildbinaries.sh Minor tweaks Apr 4, 2016
dockward.gif Add image. Mar 2, 2016
glide.lock upate library, vendor deps Apr 16, 2018
glide.yaml
main.go Refactor. Mar 1, 2016

README.md

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

You can’t perform that action at this time.