summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/README.md1
-rw-r--r--doc/gitlab_basics/README.md2
-rw-r--r--doc/gitlab_basics/create_your_ssh_keys.md37
3 files changed, 39 insertions, 1 deletions
diff --git a/doc/README.md b/doc/README.md
index 28459613252..424b9e9a47e 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -4,6 +4,7 @@
- [API](api/README.md) Automate GitLab via a simple and powerful API.
- [GitLab as OAuth2 authentication service provider](integration/oauth_provider.md). It allows you to login to other applications from GitLab.
+- [GitLab Basics](gitlab_basics/README.md) Find step by step how to start working on your commandline and on GitLab.
- [Importing to GitLab](workflow/importing/README.md).
- [Markdown](markdown/markdown.md) GitLab's advanced formatting system.
- [Permissions](permissions/permissions.md) Learn what each role in a project (guest/reporter/developer/master/owner) can do.
diff --git a/doc/gitlab_basics/README.md b/doc/gitlab_basics/README.md
index c434e0146e3..de56c3ab4fc 100644
--- a/doc/gitlab_basics/README.md
+++ b/doc/gitlab_basics/README.md
@@ -4,4 +4,4 @@ Step-by-step guides on the basics of working with Git and GitLab.
* [Start using Git on the commandline](start_using_git.md)
-
+* [Create and add your SSH Keys](create_your_ssh_keys.md)
diff --git a/doc/gitlab_basics/create_your_ssh_keys.md b/doc/gitlab_basics/create_your_ssh_keys.md
new file mode 100644
index 00000000000..1e7f7c28513
--- /dev/null
+++ b/doc/gitlab_basics/create_your_ssh_keys.md
@@ -0,0 +1,37 @@
+# How to create your SSH Keys
+
+You need to connect your computer to your GitLab account through SSH Keys. They are unique for every computer that you link your GitLab account with.
+
+## Generate your SSH Key
+
+* Create an account on GitLab. Sign up and check your email for your confirmation link
+
+* After you confirm, go to [gitlab.com](https://about.gitlab.com/) and sign in to your account
+
+## Add your SSH Key
+
+* At the top right corner, click on "profile settings"
+
+![profile settings](basicsimages/profile_settings.png)
+
+* On the left side menu click on "SSH Keys"
+
+![SSH Keys](basicsimages/shh_keys.png)
+
+* Then click on the green button "Add SSH Key"
+
+![Add SSH Key](basicsimages/add_sshkey.png)
+
+* There, you should paste the SSH Key that your commandline will generate for you. Below you'll find the steps to generate it
+
+![Paste SSH Key](basicsimages/paste_sshkey.png)
+
+## To generate an SSH Key on your commandline
+
+* Go to your [commandline](start_using_git.md) and follow the [instructions](https://gitlab.com/help/ssh/README) to generate it
+
+* Copy the SSH Key that your commandline created and paste it on the "Key" box on the GitLab page. The title will be added automatically
+
+![Paste SSH Key](basicsimages/key.png)
+
+* Now, you'll be able to use Git over SSH, instead of Git over HTTP.