1. Resources
  2. /
  3. Plugins
  4. /
  5. ssh-keyscan-buildkite-plugin

SSH Keyscan

Run ssh-keyscan into a known hosts file as a pre-command hook for use in Buildkite builds.

Your pipeline may be using HTTPS repositories but you also need to use SSH, so you can’t rely on built-in ssh keyscan priming your known hosts file. Or maybe you’re using Terraform with SSH modules. Or you’re doing SSH operations against a deployment environment.

Example

steps:
- plugins:
  - sj26/ssh-keyscan:
      host: github.com
  command: ssh clone git@github.com:buildkite/bash-example.git

Choosing known hosts location

By default, the host key will be scanned into ~/.ssh/known_hosts.

You can scan into a different location usign the known_hosts_path parameter:

steps:
- plugins:
  - sj26/ssh-keyscan:
      host: github.com
      known_hosts_path: /etc/ssh/ssh_known_hosts

Caveats

ssh-keyscan will always run, and always append to the known hosts file, even if the host entry already exists. This may be solved in a future version.

Only one host can be scanned. You can add this plugin multiple times as a workaround. Multiple hosts may be supported in a future version.

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025