James Moger
2014-03-19 eec333e07be744bcc3a1fea4449000d48bd5234c
src/site/setup_transport_ssh.mkd
@@ -23,8 +23,8 @@
Then you can upload your *public* key right from the command-line.
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit add-key
    cat c:\<userfolder>\.ssh\id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit add-key
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit keys add
    cat c:\<userfolder>\.ssh\id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit keys add
**NOTE:** It is important to note that *ssh-keygen* generates a public/private keypair (e.g. id_rsa and id_rsa.pub).  You want to upload the *public* key, which is denoted by the *.pub* file extension.
@@ -52,36 +52,32 @@
### SSH Commands
#### git
You will likely never directly interact with the git command, but it is used by your git client to clone, fetch, and push commits to/from your Gitblit server.
##### git-receive-pack
This is the command for processing pushes sent from clients.
##### git-upload-pack
This is the command for sending refs and commits to clients.
Gitblit supports SSH command plugins and provides several commands out-of-the-box.
#### gitblit
The *gitblit* command has many subcommands for interacting gitblit.
The *gitblit* command has many subcommands for interacting with Gitblit.
##### add-key
##### keys add
Add an SSH public key to your account.  This command accepts a public key piped to stdin.
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit add-key
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit keys add
##### rm-key
##### keys remove
Remove an SSH public key from your account.  This command accepts a public key piped to stdin.
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit rm-key
    cat ~/.ssh/id_rsa.pub | ssh -l <username> -p 29418 <hostname> gitblit keys remove
You can also remove all your public keys from your account.
    ssh -l <username> -p 29418 <hostname> gitblit rm-key ALL
    ssh -l <username> -p 29418 <hostname> gitblit keys remove ALL
##### keys list
Show the SSH keys you have added to your account.
    ssh -l <username> -p 29418 <hostname> gitblit keys list