faq git

swarmlab/files/help/HowTo-gitea-ssh.adoc

@@ -0,0 +1,107 @@
+= Generating a new SSH key and adding it to the ssh-agent!
+Apostolos rootApostolos@swarmlab.io
+// Metadata:
+:description: IoT  Εισαγωγή στο SwarmLab
+:keywords: iot, swarm
+:data-uri:
+:toc: right
+:toc-title: Πίνακας περιεχομένων
+:toclevels: 4
+:source-highlighter: highlight
+:icons: font
+:sectnums: 
+
+
+
+{empty} +
+
+
+This HowTo teaches you how to Generating a new SSH key and adding it to the ssh-agent. 
+
+
+[WARNING]
+====
+
+ Write Access is *ONLY* with "SSH Key-Based Authentication" Allowed
+
+
+[NOTE]
+====
+Using the SSH protocol, you can connect and authenticate to remote servers and services. With SSH keys, you can connect to Swarmlab.io git Service without supplying your username or password at each visit.
+====
+
+====
+
+== Generating a new SSH key
+
+- Open Terminal.
+
+[source, bash]
+----
+ssh-keygen -t rsa -b 4096 -C "your_email@swarmlab.io"
+----
+
+- This creates a new ssh key, using the provided email as a label.
+
+[NOTE]
+====
+    When you're prompted to "Enter a file in which to save the key," press Enter. This accepts the default file location.
+
+[source, bash]
+----
+    > Enter a file in which to save the key (/home/you/.ssh/id_rsa): [Press enter]
+
+    At the prompt, type a secure passphrase. For more information, see "Working with SSH key passphrases".
+
+    > Enter passphrase (empty for no passphrase): [Type a passphrase]
+    > Enter same passphrase again: [Type passphrase again]
+----
+====
+
+
+== Adding your SSH key to the ssh-agent
+
+
+[source, bash]
+----
+Host git.swarmlab.io
+    HostName git.swarmlab.io
+    Preferredauthentications publickey
+    IdentityFile /home/user/.ssh/file_ssh_key // <1>
+    User git 
+    Port 2222 
+----
+<1> key path
+
+
+
+== Adding a new SSH key to your Swarmlab.io account
+
+
+- Copy the SSH key to your clipboard.
+
+- In the upper-right corner of "Git Service", click Settings. 
+
+image::images/gitea-ssh-key-1.png[]
+
+- In the user settings menou, click "SSH/GPG keys". 
+
+image::images/gitea-ssh-key.png[]
+
+- Paste your key into the "Content" field. 
+
+
+
+
+
+
+:hardbreaks:
+
+{empty} +
+{empty} +
+{empty} 
+
+:!hardbreaks:
+
+'''
+

swarmlab/files/help/faq.adoc

@@ -19,6 +19,8 @@ For any questions not addressed in this list please do not hesitate to contact o
 
 === http://docs.swarmlab.io/SwarmLab-HowTos/swarmlab/files/help/HowTo-gitea.adoc.html[HowTo-create Repo] 
 
+=== http://docs.swarmlab.io/SwarmLab-HowTos/swarmlab/files/help/HowTo-gitea-ssh.adoc.html[HowTo-Generating a new SSH key] 
+
 
 == noVNC