OSDN Git Service

Better ssh key docs.
[wvm/gitlab.git] / app / views / help / ssh.html.haml
1 = render layout: 'help/layout' do
2   %h3.page-title SSH Keys
3
4   %p.slead
5     SSH key allows you to establish a secure connection between your computer and GitLab
6
7   %p.slead
8     Before generating an SSH key, check if your system already has one by running cat ~/.ssh/id_rsa.pub . If your see a long string starting with 'ssh-rsa' or 'ssh-dsa', you can skip the ssh-keygen step.
9
10   %p.slead
11     To generate a new SSH key just open your terminal and use code below. The ssh-keygen command prompts you for a location and filename to store the key pair and for a password. When prompted for the location/filename, you can press enter to use the default. It is a best practice to use a password for an SSH key but it is not required and you can skip the step by pressing enter. Note that the password you choose here can't be altered or retrieved.
12
13   %pre.dark
14     ssh-keygen -t rsa -C "#{current_user.email}"
15
16   %p.slead
17     Use code below to show your public key.
18
19   %pre.dark
20     cat ~/.ssh/id_rsa.pub
21
22   %p.slead
23     Copy-paste the key to the 'My SSH Keys' section under the 'SSH' tab in your user profile. Please copy the complete key starting with 'ssh-' and ending with your username and host.