A Gentle Introduction to the Inria's Forge

Creating an account

You need to create an account if you want to:

• join a project
• register your own project

You have to :

1. go to Forge's front page
2. Click on New account (at upper right)
3. Fill in the requested fields and click Register.

Once your account has been created, you can access it through Log in link at Front page's upper right or directly at https://gforge.inria.fr/my/.

Configure your SSH access

If you want to:

• checkout code from repositories
• modify the project homepage
• upload files to your private homedir

Modifications of your SSH setup might take some time (avg 1 Hr) to be effective in the system.

Creating a project

To create a project, you need :

1. to have already a Forge's account ; please make sure you have followed the steps described here.
2. to have an email address belonging to an INRIA domain registered for your Forge's account.

Please note :

• Pay attention to the 4th point : Source Code

  If you intend to use a source control manager (SCM), please select either Subversion or Git.

  • Once the project created, go to project > Admin > Tools and check Use source code

    It will add a SCM tab at your project that you let you administrate this component and let you know the command lines to checkout the code.

Since project approval is automatic, the Forge's administration team reserve the right to control aposteriori the project requests and to suspend any project that do not comply with the criteriae wanted by Inria.

Once approved, it might take some time (several hours) before the Forge system creates effectively the code repository (be it SVN or GIT). If any repository has not been created 24 houts after the approval, please contact the support (see below).

Private and Public projects

A project can be more or less open to public visitors. These settings are to the charge of the project's administrator(s).
Remember that in all cases, informations in project's homepage are accessible to the public Internet.

Inside your project's tab on the Forge's web UI, go to Admin > Users and Permissions > Available externam roles > Anonymous/not logged in

• Click on Link external role
• Click on Edit Permissions
• Set Project visibility/Project administration/SCM/Webcal accesses at your convenience, from the point of view of role above.

Joining a project

To join a project, you need to:

• create an account
• click on project members > Request to join link at bottom right of project's page.
• if you are going to actively participate you should also "Configure your SSH access".

Creating a code repository

Once your project approved, if you don't formerly choose a SCM (SVN/GIT), you can add a repository whenever you want.

• Go to project > Tools and check Use source code.
• Then go to SCM > Administration and choose between Subversion or Git.

If the project has already a SCM repository, selecting the other SCM choice will add another repository to the project without suppressing the former.
It's up to the project members to manage any synchronization or data migration between the SVN and GIT repositories.

For extensive informations about how to use Subersion or Git, please consider :

• For Subversion : svnbook.red-bean.com
• For Git : git-scm.com/book

For more information on importing a large tree of files, see the subversion manual and more specifically, the import section.

If you want to import the previous history from an existing svn repository, follow the steps described in the FAQ.

Once you have imported a new module, you can access it by following the instructions located in the SCM page.

To add and deal with the data located in this module, you need to use a number of different svn commands. Read the svn manual for more information on how to use them.

On windows, we recommend you to use the tortoise graphical utility to access your cvs or subversion repository. See our tortoise webpage for information on how to install and use it.

Configuring Eclipse to work with the forge

If you want to use Eclipse to :

• manage your SSH connection
• manage your SCM repository