Go to file
mmmohebi 8b5ed3cd19 fix: Initialize dockerClient to None
Changed dockerClient initialization to None to defer client creation until needed. This may prevent issues with early initialization in certain environments.
2025-11-18 13:07:49 +03:30
.github/workflows feat(github actions): lowercase repo name for image tag 2025-11-18 12:53:42 +03:30
.dockerignore feat: Add Dockerfile, .dockerignore, and CI workflow 2025-11-18 12:38:11 +03:30
.gitignore fix: Add hosts to .gitignore 2025-11-18 11:40:47 +03:30
Dockerfile feat(docker-hoster): Update default socket path and Dockerfile CMD 2025-11-18 13:01:45 +03:30
LICENSE fix: Update LICENSE copyright 2025-11-18 12:24:53 +03:30
README.md feat(docker-hoster): Update default socket path and Dockerfile CMD 2025-11-18 13:01:45 +03:30
hoster.py fix: Initialize dockerClient to None 2025-11-18 13:07:49 +03:30
requirements.txt feat: Add project dependencies 2025-11-18 12:24:43 +03:30

README.md

Hoster

A simple "etc/hosts" file injection tool to resolve names of local Docker containers on the host.

hoster is intended to run in a Docker container:

docker run -d \
    -v /var/run/docker.sock:/tmp/docker.sock \
    -v /etc/hosts:/tmp/hosts \
    ghcr.io/mrmohebi/docker-hoster:latest

The docker.sock is mounted to allow hoster to listen for Docker events and automatically register containers IP.

Hoster inserts into the host's /etc/hosts file an entry per running container and keeps the file updated with any started/stoped container.

Container Registration

Hoster provides by default the entries <container name>, <hostname>, <container id> for each container and the aliases for each network. Containers are automatically registered when they start, and removed when they die.

For example, the following container would be available via DNS as myname, myhostname, et54rfgt567 and myserver.com:

docker run -d \
    --name myname \
    --hostname myhostname \
    --network somenetwork --network-alias "myserver.com" \
    mycontainer

If you need more features like systemd interation and dns forwarding please check resolvable

Any contribution is, of course, welcome. :)