{"id":18400457,"url":"https://github.com/docksal/service-ssh-agent","last_synced_at":"2025-04-07T06:33:29.454Z","repository":{"id":11346335,"uuid":"69376437","full_name":"docksal/service-ssh-agent","owner":"docksal","description":"SSH agent service image for Docksal","archived":false,"fork":false,"pushed_at":"2022-03-06T21:48:22.000Z","size":48,"stargazers_count":9,"open_issues_count":0,"forks_count":11,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2024-05-22T19:17:01.692Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://docksal.io","language":"Shell","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/docksal.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-09-27T16:24:55.000Z","updated_at":"2022-05-25T15:36:01.000Z","dependencies_parsed_at":"2022-08-07T06:01:22.518Z","dependency_job_id":null,"html_url":"https://github.com/docksal/service-ssh-agent","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docksal","download_url":"https://codeload.github.com/docksal/service-ssh-agent/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208455,"owners_count":20901570,"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-06T02:33:31.252Z","updated_at":"2025-04-07T06:33:26.458Z","avatar_url":"https://github.com/docksal.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SSH Agent Docker image for Docksal\n\nThis image(s) is part of the [Docksal](http://docksal.io) image library.\n\nThe exposed ssh-agent socket will be accessible to all users (not only root) in any container.  \nThis is achieved by exposing a proxy socket (`/.ssh-agent/proxy-socket`) via socat.\n\n\n## Usage\n\n### 1. Start the ssh-agent container \n\n```bash\ndocker run -d --name=ssh-agent docksal/ssh-agent\n```\n\n### 2. Add your ssh keys\n\nReplace `~/.ssh` with the path to your keys and `id_rsa` with the key name.  \nIf the key has a passphrase, you will be asked to enter it.\n\n```bash\ndocker run --rm --volumes-from=ssh-agent -v ~/.ssh:/root/.ssh -it ssh-agent ssh-add /root/.ssh/id_rsa\n```\n\n### 3. Access SSH keys from the ssh-agent in other containers\n\nMount the ssh-agent socket and set the `SSH_AUTH_SOCK` variable in other containers.\n\nDocker\n\n```bash\ndocker run --rm --volumes-from=ssh-agent -e SSH_AUTH_SOCK=/.ssh-agent/proxy-socket-it \u003cimage\u003e ssh-add -l\n```\n\nDocker Compose\n\n```yaml\n  ...\n  volumes_from:\n    - ssh-agent\n  ...\n  environment:\n    - SSH_AUTH_SOCK /.ssh-agent/proxy-socket\n  ...\n```\n\n### Deleting all keys from the ssh-agent\n\n```bash\ndocker run --rm --volumes-from=ssh-agent -it docksal/ssh-agent ssh-add -D\n```\n\n### Running in TCP proxy mode\n\nThis image supports creating a Unix socket that connects to a remote TCP socket, e.g. when connecting\nto a remote machine that exposes a Unix socket as a TCP endpoint.\n\n```bash\ndocker run -d --name=ssh-agent docksal/ssh-agent ssh-proxy {host/IP} {TCP port}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fservice-ssh-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocksal%2Fservice-ssh-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fservice-ssh-agent/lists"}