First Steps on pagure

=====================

When coming to pagure for the first time there are a few things one should

do or check to ensure all works as desired.

Login to pagure or create your account

--------------------------------------

Pagure has its own user account system.

For instances of pagure such as the one at `pagure.io <https: pagure.io="">`_</https:>

where the authentication is delegated to a third party (in the case of

pagure.io, the Fedora Account System) via OpenID, the local user account

is created upon login.

This means, you cannot be added to a group or a project before you login for

the first time as the system will simply not know you.

If you run your own pagure instance which uses the local authentication

system, then you will find on the login page an option to create a new

account.

Upload your SSH key

-------------------

Pagure uses gitolite to manage who has read/write access to which git

repository via `ssh <https: en.wikipedia.org="" secure_shell="" wiki="">`_.</https:>

An ssh key is composed of two parts:

* a private key, which you must keep to yourself and never share with anyone.

* a public key, which is public and therefore can be shared with anyone.

If you have never generated a ssh key, you can do so by running:

::

    ssh-keygen

or alternatively on GNOME using the application ``seahorse``.

This will create two files in ``~/.ssh/`` (``~`` is the symbol for your home

folder).

These two files will be named (for example) ``id_rsa`` and ``id_rsa.pub``.

The first one is the private key that must never be shared. The second is

the public key that can be uploaded on pagure to give you ssh access.

To upload your public key onto pagure:

1. Login into pagure and click on the user icon on

the top right corner, there, select ``My settings``.

.. image:: _static/pagure_my_settings.png

        :target: _static/pagure_my_settings.png

2. In the authentication section of your user settings copy the content of your

``id_rsa.pub`` file in the Public SSH key text box and save your ssh key settings.

.. image:: _static/pagure_add_ssh_key.png

        :target: _static/pagure_add_ssh_key.png

.. note:: Pagure support multiple ssh keys per user, to add more than a ssh key

          to your user account just add your new ssh key in your authentication

          settings (one key per row), this way you will be able to push commits

          to your repository from a different computer.

Configure the default email address

-----------------------------------

If the pagure instance you use is using local user authentication, then when

you created your account you could choose whichever email address you prefer

to use, but in the case (like pagure.io) where the pagure instance relies

on an external authentication service, the email address provided by this

service may be different from the one you prefer.

Your settings' page (cf the image above for how to access to the page) allow

you to add multiple email address and set one as default.

Your default email address is the address that will be used to send you

notifications and also as the email address in the git commit if you merge

a pull-request with a merge commit.

For online editing, when doing the commit, you will be presented with the

list of valid email addresses associated with your account and you will be

able to choose which one you wish to use.

.. note:: All email address will need to be confirmed to be activated, this

          is done via a link sent by email to the address. If you do not

          receive this link, don't forget to check your spam folder!