{"id":34236171,"url":"https://github.com/netkant/docker-node-identities","last_synced_at":"2026-01-13T21:56:41.863Z","repository":{"id":57527931,"uuid":"74701865","full_name":"netkant/docker-node-identities","owner":"netkant","description":"A tool that will create/remove users and groups on a docker node, if required by a container.","archived":false,"fork":false,"pushed_at":"2018-08-17T12:38:10.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-19T08:53:36.618Z","etag":null,"topics":["docker","docker-node"],"latest_commit_sha":null,"homepage":"","language":"Go","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/netkant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-24T20:02:24.000Z","updated_at":"2023-12-30T15:52:17.000Z","dependencies_parsed_at":"2022-09-26T16:31:09.680Z","dependency_job_id":null,"html_url":"https://github.com/netkant/docker-node-identities","commit_stats":null,"previous_names":["urlund/docker-node-identities","netkant/docker-node-identities"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/netkant/docker-node-identities","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netkant%2Fdocker-node-identities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netkant%2Fdocker-node-identities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netkant%2Fdocker-node-identities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netkant%2Fdocker-node-identities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netkant","download_url":"https://codeload.github.com/netkant/docker-node-identities/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netkant%2Fdocker-node-identities/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-node"],"created_at":"2025-12-16T02:37:09.530Z","updated_at":"2026-01-13T21:56:41.858Z","avatar_url":"https://github.com/netkant.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-node-identities\nA tool that will create/remove users and groups on a docker node, if required by a container.\n\n## Flags\n\n```\n$ docker-node-identities -h\nUsage of docker-node-identities:\n  -debug\n    \tShow debug info\n  -docker-api-version float\n    \tDocker API version (default 1.24)\n  -docker-cert-path string\n    \tPath to TLS files\n  -docker-host string\n    \tDaemon socket to connect to (default \"unix:///var/run/docker.sock\")\n  -docker-tls-verify\n    \tUse TLS and verify the remote\n  -group-label string\n    \tLabel containing group config (default \"docker.node.identities.group\")\n  -user-label string\n    \tLabel containing user config (default \"docker.node.identities.user\")\n  -version\n    \tShow version\n```\n\n## Labels\n\n### Group\nContent of the group label is expected to be `name:password:gid:members` - if you recognize this syntax, it's because you will find it in `/etc/group`.\n\nNote: `members` will be ommited.\n\n### User\nContent of the user label is expected to be `username:password:uid:gid:comment:home:shell` - and yes, you might already have guessed it, it's just like `/etc/passwd`.\n\n## Install on docker node\nTo keep things running, you can use systemd:\n\n```\nwget -O /usr/local/bin/docker-node-identities https://github.com/urlund/docker-node-identities/releases/download/1.0.4/docker-node-identities-linux-amd64\nwget -O /etc/systemd/system/docker-node-identities.service https://raw.githubusercontent.com/urlund/docker-node-identities/master/docker-node-identities.service\nchmod +x /usr/local/bin/docker-node-identities\nservice docker-node-identities start\n```\n\nNow `docker-node-identities` should be running and ready to keep your users/groups in sync.\n\n## Examples\nThe most basic example will create a user `johndoe` (uid: `1001`), and a group `johndoe` (gid: `1001`)\n\n```bash\ndocker run -d -p 80:80 -l \"docker.node.identities.user=johndoe::1001\" nginx\n```\n\nThis properly wouldn't make much sense if you are running a single instance, but let's assume you are running a service of 10 (or more) replicas, it would be rather trivial to create the same user on all nodes running or service, so this will make your day:\n\n```bash\ndocker service create -p 80:80 -l \"docker.node.identities.group=thedoes::1010\" -l \"docker.node.identities.user=johndoe::1001:1010\" nginx\n```\n\nNow all nodes running a replica will have the user `johndoe` (uid: `1001`) created, and added to the group `thedoes` (gid: `1010`). Scaling the service to 5 and the nodes no longer running a replica will have the user and group removed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetkant%2Fdocker-node-identities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetkant%2Fdocker-node-identities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetkant%2Fdocker-node-identities/lists"}