Wiki¶

Setup SSH keys for repository access¶

If you have not done so, setup SSH keys.

Checking for existing SSH keys¶

Before you generate an SSH key, you can check to see if you have any existing SSH keys. Open Terminal and type:

$ ls -al ~/.ssh

By default, the filenames of the public keys are one of the following:

• id_ecdsa.pub
• id_ed25519.pub
• id_rsa.pub

If you don't have an existing public and private key pair, or don't wish to use any that are available to connect to Redmine, then generate a new SSH key (see below).

If you see an existing public and private key pair listed (for example id_rsa.pub and id_rsa) that you would like to use to connect to Redmine, you can skip the next section.

Generating a new SSH key¶

Paste the text below, substituting in your e-mail address.

$ ssh-keygen -t rsa -b 4096 -C "your_email@p.lodz.pl"

This creates a new ssh key, using the provided email as a label.

Generating public/private rsa key pair.

When you're prompted to "Enter a file in which to save the key," press Enter. This accepts the default file location.

Enter a file in which to save the key (/home/you/.ssh/id_rsa): [Press enter]

At the prompt, type a secure passphrase.

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

Adding your public key to Redmine¶

In the terminal type:

$ cat ~/.ssh/id_rsa.pub

and copy to printed output (similar to the one below) to the clipboard.

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDVto31yS/LLcl2S08ULCo0lc8kcMFCgDyRsi+VZEVsOEz+Ou4/Iuyg20jALy
4ITGztkga0nulq+SF45WlgqoYlhmwI1tnxJf/HNHqTLMINfBFOkW1MBTzq2xZYkHMaLe4RL7GSyJcJahnGNUDIKJuWyYYpmjaj
/ijfbJJb63FAeV4swXo5nGyI3TvIUzGtNINvoNqTiHxLL0aJnAqQcu4XiZ9PiAQND8tCJa+MnbeaUIRQAx00OsjCY8ey+rTbK4
atE92TR4iRWF8x0l0KlOec6Ti2qopy+VXMIf8HpYFHZJRSnzUDwuuzK1UTdA+H3Gl3UEEFxJnQcH5Y3mvxm3iB your_email@p.lodz.pl

Next open https://phys.p.lodz.pl/redmine/my/public_keys. In the section Enter new public key, type any identifier you want and paste the contents of the clipboad (your public key) into the Public key window. Leave Public key type set to User key. Click Create. Your key should show up in the list at the top of the screen.