To register a new project:
Creating a new project is easy!
- Login with your SourceForge.net account, or if you do not have an account, register one here.
- Go to the Project Registration page
- Type in the new Project Name and "url name" (3-30 characters long, using only letters, numbers, and dashes) -- this name will determine the project's URL and UNIX group in SourceForge services. Take care when selecting your url name, unlike other settings, this is not easily changed once you've registered your project. If you need to rename a url name, please log a support ticket for that.
- Click on any of the services that you would like to be initially enabled. You can add or delete services at any time, as mentioned below. For an overview of our services, see our Documentation Front Page page.
Congratulations! You are the proud owner of a shiny new SourceForge project.
To configure your project:
When you create a new project, you automatically are given administrator rights for that particular project.
After you create your new project, you will be brought to the project's "Metadata" page. Following are details for what each item is for:
- Name: This is the publicly viewable name of the project, and will appear on project listings. It should be the full name of your project.
- Unixname: This cannot be changed without logging a ticket with SourceForge support. Keep in mind that changing this will update the url to access your project which may result in broken links and bookmarks.
- Home Page: This is a URL to your project's Homepage if you have a website for your project.
- Short Summary: This is a text-only project summary which will be included on search results and project listings. Typically this is one or two sentences describing the project, and is text-only.
- Full Description: This is a longer text-only description. Use this to describe your project in greater depth than just the short summary. This is shown in search results in the expanded detail view.
- Support Page: Use this to indicate the best way for your users to get help with your software.
- Icon: This is where you can upload the icon for your project. It will be shown on the project home page and in search results. If no icon is uploaded, the default SourceForge.net project icon will be used.
- Project Status: If you later stop development, or move hosting for your project to a different location, you can use this setting to indicate that on your summary page.
- Export Controls: Set this to the appropriate setting to comply with export laws. See the "Why?" link for more information on this.
To add users to your project:
You must have administrator rights in order to do this. On the admin screen of your project, click on the User Permissions link. You will see fields to add users to "Admin" and "developer."
By default, admins have complete control over the project including tool configurations; developers have read+write access within all of the tools.
You can add users to either group by typing in their "username", which they select when they register their account. This is a UNIX-compatible unique name which contains no spaces and is used for log in to source code repositories. Any new users will need to register accounts at: http://sourceforge.net/account/registration/. Before logging on, they will need to click on the link in the validation email they’ll receive after they create their account in order for their IDs to be registered in the system.
You must have administrator rights in order to do this. On the admin screen of your project, click on the Tools link. In the top section, you there's a listing of installable tools, click the desired tool, then choose a "Label" and "Mountpoint".
- The Label is what shows in the project's navigation bar, this can be re-configured later if necessary.
- The Mount Point is used to determine the URL of the tool. This cannot be changed after the tool is created. For example, if my project's URL name is uberproject, and I create a new Tickets tool with the mount point bugs, that new Tickets instance will be installed to
If you decide you no longer need one of the tools available, simply click Delete and the tool will be permanently removed from your project.
You can install multiple tools of the same type, however, to save space in the navigation bar, they will be collapsed into a single menu item. The bottom of Admin -> Tools will let you change the threshold for the number of the same tool before collapsing same types.