2. Getting Started

2.1. GForge homepage
2.2. Registering as a new user
2.3. Registering a new project
2.4. Login
2.5. Logout

2.1. GForge homepage

Connect with your browser to GForge. This can be either http://gforge.org or a locally-installed version of the software.

2.2. Registering as a new user

To register a new user, click on the New Account link on the top right side of the browser window.

To register as a user, you need to fill out the form with the following data:

Login Name

You should select an unique user name to access to the system. The name should not contain uppercase letters and usually is a combination of your name and your surname; e.g. jdoe for John Doe. Also, the user name cannot match that of an existing system user account - i.e., you can't have a GForge user named 'root'.

Password

You should insert your password here. It must be at least 6 characters long. You shouldn't use too obvious names for the password. It should be easy to remember for you, but hard to guess for others. So don't use the name of your dog, of your cat, or the name of your birth city.

You should use instead a combination of letters and numbers.

Full/Real Name

Here you should insert your full name.

Language Choice

Select here your preferred language. This choice does not influence only the language in which GForge will speak to you, but also some local specific data display, like dates, etc.

Timezone

Select your timezone. Note that GMT is preselected. All dates will be showed relative to your timezone.

Email Address

You should insert your email address here.

The email address should be correct, GForge will send you a confirmation email for your subscription. If the email address you're inserting here is wrong, you'll never receive the confirmation email and the account you're registering will never be activated.

When you receive the confirmation email, you must connect to GForge using the provided URL in the email. This is the only way to become a registered user.

Receive Email about Site Updates

If you check this, you'll periodically receive information about the GForge site. The traffic is very low, it is recommended that you activate this option.

Receive additional community mailings

If you check this, you will receive information about the site's community.

2.3. Registering a new project

To register a new project, connect to your GForge , login and go to My Page section. You have a Register Project link in the menu at the top of the page.

You need to insert the following information to register a project:

Project Full Name

The Name of the Project: eg. Gforge Master project

Project Purpose and Summarization

A brief summary of the Project

License

You must select a License for your software.

Project Public Description

Insert a description of the Project. This description will appear in the Project Summary page

Project Unix Name

Insert here the unix name of your project. This name must respect the following rules:

  1. it cannot match the unix name of any other project

  2. its length must be between 3 and 15 characters

  3. it must be in lowercase

  4. only characters, numbers and dashes are accepted

The unix name will be used for your website, the CVS Repository and the shell access for GForge.

Note

the unix name will never change. Once a project is set up with its unix name, the name cannot be changed.

Click on the I agree button to register the project. Your project is now registered on GForge; but you cannot yet access it. It has to be approved from the site administrators.

When the project is approved, you'll receive an email from GForge confirming that the project is active.

2.4. Login

You can login by clicking the Login link in the top-right border of the browser window.

The form requires that you insert your username and your password to access the site. If the data is correct, the user homepage will be displayed.

2.5. Logout

To log out from GForge, click on the Logout link on the top right of your browser window.