{"id":16162610,"url":"https://github.com/jmb12686/docker-socat","last_synced_at":"2026-06-17T20:31:32.105Z","repository":{"id":94621202,"uuid":"216094850","full_name":"jmb12686/docker-socat","owner":"jmb12686","description":"Multi-architecture, containerized socat command.  Used to relay arbitrary socket data or specifically to export experimental Docker daemon metrics to Prometheus","archived":false,"fork":false,"pushed_at":"2020-07-13T15:39:26.000Z","size":13,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-13T08:29:25.323Z","etag":null,"topics":["docker","docker-swarm","multi-arch-images"],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmb12686.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":"2019-10-18T19:36:15.000Z","updated_at":"2024-01-15T00:24:05.000Z","dependencies_parsed_at":"2023-04-21T08:17:40.611Z","dependency_job_id":null,"html_url":"https://github.com/jmb12686/docker-socat","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"77726e25368e5bf5cebbaeeac68fde50a66488d1"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmb12686%2Fdocker-socat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmb12686%2Fdocker-socat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmb12686%2Fdocker-socat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmb12686%2Fdocker-socat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmb12686","download_url":"https://codeload.github.com/jmb12686/docker-socat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247589835,"owners_count":20963022,"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":["docker","docker-swarm","multi-arch-images"],"created_at":"2024-10-10T02:31:28.459Z","updated_at":"2026-06-17T20:31:27.058Z","avatar_url":"https://github.com/jmb12686.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-socat (multi-architecture socat Docker image)\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hub.docker.com/r/jmb12686/socat/tags?page=1\u0026ordering=last_updated\"\u003e\u003cimg src=\"https://img.shields.io/github/v/tag/jmb12686/docker-socat?label=version\u0026style=flat-square\" alt=\"Latest Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/jmb12686/docker-socat/actions\"\u003e\u003cimg src=\"https://github.com/jmb12686/docker-socat/workflows/build/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/jmb12686/socat/\"\u003e\u003cimg src=\"https://img.shields.io/docker/stars/jmb12686/socat.svg?style=flat-square\" alt=\"Docker Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/jmb12686/socat/\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/jmb12686/socat.svg?style=flat-square\" alt=\"Docker Pulls\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nInspired by [stefanprodan/dockerd-exporter](https://github.com/stefanprodan/dockerd-exporte) with added support for ARM / ARM64 multiarchitecture images.  Runs the `socat` program in a base alpine image.  Can be used to relay arbitrary socket data or specifically export experimental Docker daemon metrics to Prometheus.\n\n## Install and Usage\n\n### Setup Docker Engine\n[Enable experimental metrics for docker engine](https://docs.docker.com/config/thirdparty/prometheus/#configure-docker) for address `0.0.0.0:9323`.  \n\nCheck if the docker_gwbridge ip address is 172.18.0.1:\n\n `docker run --rm --net host alpine ip -o addr show docker_gwbridge`\n\n### Docker Swarm \n\nCreate an overlay network:\n\n```sh\ndocker network create \\\n  --driver overlay \\\n  netmon\n```\n\nCreate dockerd-exporter global service (replace 172.18.0.1 with your docker_gwbridge address):\n\n```sh\ndocker service create -d \\\n  --mode global \\\n  --name dockerd-exporter \\\n  --network netmon \\\n  -e IN=\"172.18.0.1:9323\" \\\n  -e OUT=\"9323\" \\\n  jmb12686/socat:latest \\\n  -d -d TCP-L:9323,fork TCP:172.18.0.1:9323\n```\n\nConfigure Prometheus to scrape the dockerd-exporter instances:\n\n```\nscrape_configs:\n- job_name: 'dockerd-exporter'\n  dns_sd_configs:\n  - names:\n    - 'tasks.dockerd-exporter'\n    type: 'A'\n    port: 9323\n```\n\nRun Prometheus on the same overlay network as dockerd-exporter.\n\n## Build and Publish Socat Image\nThis image is designed to support multiarchitecture images for usage on both ARM and amd64 hosts.  Setup local environment to support Docker experimental feature for building multi architecture images, [buildx](https://docs.docker.com/buildx/working-with-buildx/).  Follow instructions [here](https://engineering.docker.com/2019/04/multi-arch-images/)\n\nClone repo:\n```bash\n$ git clone https://github.com/jmb12686/raspi-docker-stacks\n$ cd raspi-docker-stacks/prometheus/dockerd-exporter\n```\n\nBuild multiarch image:\n```bash\n$ docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t jmb12686/socat:latest --push .\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmb12686%2Fdocker-socat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmb12686%2Fdocker-socat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmb12686%2Fdocker-socat/lists"}