README.md

sshb0t

A bot for keeping your ssh authorized_keys up to date with user's GitHub keys from https://github.com/{username}.keys.

WARNING: Only use this if you have two factor auth enabled for your GitHub account and you make sure to delete old keys from your account.

Table of Contents

• Installation
  • Binaries
  • Via Go
  • Running with Docker
• Usage

Installation

Binaries

For installation instructions from binaries please visit the Releases Page.

Via Go

$ go get github.com/genuinetools/sshb0t

Running with Docker

$ docker run -d --restart always \
    --name sshb0t \
    -v ${HOME}/.ssh/authorized_keys:/root/.ssh/authorized_keys \
    r.j3ss.co/sshb0t --user genuinetools --keyfile /root/.ssh/authorized_keys

Usage

$ sshb0t -h
sshb0t -  A bot for keeping your ssh authorized_keys up to date with user's GitHub keys.

Usage: sshb0t <command>

Flags:

  --url       GitHub Enterprise URL (default: https://github.com)
  --user      GitHub usernames for which to fetch keys (default: [])
  -d          enable debug logging (default: false)
  --interval  update interval (ex. 5ms, 10s, 1m, 3h) (default: 30s)
  --keyfile   file to update the authorized_keys (default: /home/jessie/.ssh/authorized_keys)
  --once      run once and exit, do not run as a daemon (default: false)

Commands:

  version  Show the version information.