{"id":18298139,"url":"https://github.com/modem7/dhcp-relay","last_synced_at":"2025-08-25T10:31:01.286Z","repository":{"id":38192590,"uuid":"258765075","full_name":"modem7/DHCP-Relay","owner":"modem7","description":"Docker DHCP Relay","archived":false,"fork":false,"pushed_at":"2024-12-06T02:29:20.000Z","size":128,"stargazers_count":10,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-06T03:25:14.130Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/modem7/dhcprelay","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/modem7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-25T12:01:41.000Z","updated_at":"2024-12-06T02:29:02.000Z","dependencies_parsed_at":"2023-09-29T10:33:31.604Z","dependency_job_id":"5cc54266-e5f6-4ca8-bbcc-bba4f068d150","html_url":"https://github.com/modem7/DHCP-Relay","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modem7%2FDHCP-Relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modem7%2FDHCP-Relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modem7%2FDHCP-Relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modem7%2FDHCP-Relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/modem7","download_url":"https://codeload.github.com/modem7/DHCP-Relay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230902154,"owners_count":18297612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T15:05:19.446Z","updated_at":"2024-12-23T01:25:24.441Z","avatar_url":"https://github.com/modem7.png","language":"Dockerfile","funding_links":["https://www.buymeacoffee.com/modem7"],"categories":[],"sub_categories":[],"readme":"# ISC DHCP Relay Agent\n\n![Docker Pulls](https://img.shields.io/docker/pulls/modem7/dhcprelay) \n![Docker Image Size (tag)](https://img.shields.io/docker/image-size/modem7/dhcprelay/latest) \n[![Build Status](https://drone.modem7.com/api/badges/modem7/DHCP-Relay/status.svg)](https://drone.modem7.com/modem7/DHCP-Relay)\n[![GitHub latest commit](https://badgen.net/github/last-commit/modem7/DHCP-Relay)](https://GitHub.com/modem7/DHCP-Relay/commit/)\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/modem7)\n\nA simple ISC DHCP Relay Agent.\n\nThe Internet Systems Consortium DHCP Relay Agent, dhcrelay, provides a means for relaying DHCP and BOOTP requests from a subnet to which no DHCP server is directly connected to one or more DHCP servers on other subnets. It supports both DHCPv4/BOOTP and DHCPv6 protocols. \n\nMore info can be found here: https://linux.die.net/man/8/dhcrelay\n\n# Tags\n| Tag | Description |\n| :----: | --- |\n| Latest | Latest release built upon the latest version. |\n| 4.4.x | Versioned release. |\n\n# Configuration\n\nIn this config, udp port 67 must be free on the host.\n\n```bash\nversion: \"2.4\"\n\nservices:\n\n #############\n ##DHCPRelay##\n #############\n \n #DHCPRelay - DHCP Relay between host network and Docker bridge\n  dhcprelay:\n    image: modem7/dhcprelay:latest\n    container_name: DHCPRelay\n    command: [\"-id\", \"eno1\", \"-iu\", \"br_pihole\", \"172.33.0.100\"] #https://fedoramagazine.org/build-network-bridge-fedora/\n    cap_add:\n      - NET_ADMIN\n    network_mode: host\n    restart: always\n    mem_limit: 20m\n    mem_reservation: 5m\n```\n\n# Commands explanation\nhttps://linux.die.net/man/8/dhcrelay\n```bash\n-i ifname\nListen for DHCPv4/BOOTP queries on interface ifname. Multiple interfaces may be specified by using more than one -i option. If no interfaces are specified on the command line, dhcrelay will identify all network interfaces, eliminating non-broadcast interfaces if possible, and attempt to listen on all of them.\n\n-d\nForce dhcrelay to run as a foreground process. Useful when running dhcrelay under a debugger, or running out of inittab on System V systems.\n\neno1\nYour NIC (you can find this with ifconfig -a)\n\n-u [address%]ifname\nSpecifies the ''upper'' network interface for DHCPv6 relay mode: the interface to which queries from clients and other relay agents should be forwarded. At least one -u option must be included in the command line when running in DHCPv6 mode. The interface name ifname is a mandatory parameter. The destination unicast or multicast address can be specified by address%; if not specified, the relay agent will forward to the DHCPv6 All_DHCP_Relay_Agents_and_Servers multicast address.\n\nbr_pihole\nYour Docker network bridge name.\n\n172.33.0.100\nThe destination IP address for the packets. Typically your PiHole bridge IP address.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodem7%2Fdhcp-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmodem7%2Fdhcp-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodem7%2Fdhcp-relay/lists"}