= 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::./gitea-ssh-key-1.png[]

- In the user settings menou, click "SSH/GPG keys". 

image::./gitea-ssh-key.png[]

- Paste your key into the "Content" field. 






:hardbreaks:

{empty} +
{empty} +
{empty} 

:!hardbreaks:

'''