Sign inSign up
github-ssh logo

sbx/github-ssh

Verified Publisher

By Docker, Inc

•Updated 2 days ago

Pre-populates GitHub host keys so SSH operations work without interactive host verification prompts.

Sandbox Kit
0

9.9K

sbx/github-ssh repository overview

Digest

sha256:134559cb65ef…

Size

3.1 kB

Schema

v3

Pushed

2 days ago

Specificationspec.yaml

MIXIN

Pre-populates GitHub host keys so SSH operations work without interactive host verification prompts.


Arguments
NameRequiredDefaultDescription
versionRequired—

Kit revision supplied by the DHI build


Providesgithub-ssh

CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/ssh-agent@1Required—
com.docker.sandbox/network-policy@1Required—
com.docker.sandbox/lifecycle@1Required—
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—

Requiresdeb/jq, deb/openssh-client

Apply this mixin to a sandbox

sbx run <agent> --kit sbx/github-ssh:latest

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS
brew install docker/tap/sbx
Windows
winget install Docker.sbx
Learn more about docker sbx⁠

⁠GitHub SSH

This v3 mixin Kit pre-populates ~/.ssh/known_hosts with GitHub's host keys so SSH operations to GitHub work without interactive host verification prompts. It composes with a compatible workload.

This Kit is built on Docker Hardened Images.

Without this kit, SSH connections from a sandbox to GitHub fail because there is no TTY available to interactively accept a new host key.

⁠Prerequisites

Your SSH key must be loaded in the agent on the host and registered with your GitHub account. Start the sandbox with this kit attached, from its published OCI artifact on Docker Hub:

sbx run sbx/claude --kit sbx/github-ssh

⁠Usage

Once the kit is installed, SSH operations to GitHub work without any additional configuration:

git clone [email protected]:org/repo.git
git push origin my-branch

⁠Composing with git-ssh-sign

If you also want SSH commit signing, combine this kit with git-ssh-sign⁠:

sbx run sbx/claude --kit sbx/github-ssh --kit sbx/git-ssh-sign

⁠How it works

At install time, the kit fetches GitHub's current SSH host keys from https://api.github.com/meta⁠ (the canonical source GitHub publishes) and appends them to /home/agent/.ssh/known_hosts. Using the HTTPS metadata endpoint works through HTTPS-only proxies where ssh-keyscan cannot reach port 22, and avoids hardcoding keys that GitHub may rotate.

⁠Requirements and scope

The workload must provide deb/jq and deb/openssh-client in addition to the v3 platform floor. Node is not required. The runtime agent grant is restricted to Git authentication as [email protected]; it permits neither Git signing nor logins elsewhere. The private key stays outside the sandbox.

There are no CREATE-time arguments. Host-key setup retains existing entries, adds only missing keys, and fails when metadata cannot be fetched or parsed. For install-time SSH cloning, combine with github-clone⁠, which separately requests an optional install-phase GitHub agent binding. This kit's own agent grant remains runtime-only.

See the Sandbox Kit v3 specification⁠ for the Kit format and capability contracts.