https://github.com/dokku/docker-wait
https://github.com/dokku/docker-wait
docker docker-image dokku paas wait
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dokku/docker-wait
- Owner: dokku
- Created: 2015-09-21T15:20:22.000Z (about 10 years ago)
- Default Branch: main
- Last Pushed: 2025-06-02T08:29:15.000Z (4 months ago)
- Last Synced: 2025-06-09T12:52:20.647Z (4 months ago)
- Topics: docker, docker-image, dokku, paas, wait
- Language: Shell
- Homepage:
- Size: 156 KB
- Stars: 27
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# docker-wait
[](https://hub.docker.com/r/dokku/wait/)
`wait` is a really small (4MB) Docker utility that blocks until another container is accepting TCP connections, and errors-out if it cannot connect within a given timeout. It can be used to ensure that a service is up and running before starting another service that depends on it.
The default operation looks up all the `EXPOSE`d ports of all the linked containers and waits for them
```shell
$ docker run -d --name mycontainer some-image-or-other
$ docker run --link mycontainer:mycontainer --rm dokku/wait
Waiting for 172.17.0.105:5432 . up!
Everything is up
```
It doesn't matter what the link alias is.
If you want to wait for only a subset of the ports in a linked container, you can provide the list with the `-p` parameter:
```shell
$ docker run -d --name mycontainer some-image-or-other
$ docker run --link mycontainer:mycontainer --rm dokku/wait -p 5432
Not checking 172.17.0.105:6379 because port is not included.
Waiting for 172.17.0.105:5432 . up!
Everything is up
```
If you want to connect to hosts/ports that haven't been linked by Docker, you can provide the list with the `-c` parameter:
```shell
$ docker run --rm dokku/wait -c 8.8.8.8:53,github.com:443
Waiting for 8.8.8.8:53 . up!
Waiting for github.com:443 . up!
Everything is up
```
By default each connection attempt will bail after 30 seconds. You can override this with `-t` parameter:
```shell
$ docker run dokku/wait -c github.com:5432 -t 15
Waiting for github.com:5432 ............................... ERROR: unable to connect
```
If any connection times out, the `wait` container immediately exits with status code 1
## credits
[waisbrot/wait](https://github.com/waisbrot/docker-wait)
[n3llyb0y/wait](https://github.com/n3llyb0y/docker-wait)
[aanand/wait](https://github.com/aanand/docker-wait)