Native SSH Client for Rancher Containers, provided a powerful native terminal to manage your docker containers
Clone or download
fangli Merge pull request #4 from Robbie1977/patch-1
correcting missing API path
Latest commit 0547d5f Jun 20, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore initial commit Aug 23, 2016 initial commit Aug 23, 2016
LICENSE fix license Aug 23, 2016 correcting missing API path Jun 13, 2017
demo.gif fixed demo and readme Aug 23, 2016
main.go version 1.1.3 Aug 24, 2016

Rancher SSH

Native SSH Client for Rancher Containers, provided a powerful native terminal to manage your docker containers

  • It's dead simple. like the ssh cli, you do rancherssh container_name to SSH into any containers
  • It's flexible. rancherssh reads configurations from ENV, from yml or json file
  • It's powerful. rancherssh searches the whole rancher deployment, SSH into any containers from your workstation, regardless which host it belongs to
  • It's smart. rancherssh uses fuzzy container name matching. Forget the container name? it doesn't matter, use "*" or "%" instead





# brew install fangli/dev/rancherssh

Or via Golang

# go get


rancherssh [<flags>] <container>


rancherssh my-server-1

rancherssh "my-server*" (equals to) rancherssh my-server%

rancherssh %proxy%

rancherssh "projectA-app-*" (equals to) rancherssh projectA-app-%


We read configuration from config.json or config.yml in ./, /etc/rancherssh/ and ~/.rancherssh/ folders.

If you want to use JSON format, create a config.json in the folders with content:

      "endpoint": "https://rancher.server/v1", // Or "https://rancher.server/v1/projects/xxxx"
      "user": "your_access_key",
      "password": "your_access_password"

If you want to use YAML format, create a config.yml with content:

  endpoint: https://your.rancher.server/v1 // Or https://rancher.server/v1/projects/xxxx
  user: your_access_key
  password: your_access_password

We accept environment variables as well:

  SSHRANCHER_ENDPOINT=https://your.rancher.server/v1   // Or https://rancher.server/v1/projects/xxxx


  -h, --help         Show context-sensitive help (also try --help-long and --help-man).
  --version      Show application version.
  --endpoint=""  Rancher server endpoint, https://your.rancher.server/v1 or https://your.rancher.server/v1/projects/xxx.
  --user=""      Rancher API user/accesskey.
  --password=""  Rancher API password/secret.


<container> Container name, fuzzy match