Project Documentation

Maven Projects

Deploying to sourceforge.net

This sf.net announcement indicates that the new hostname for project web file management has changed. The new hostname for file management is: web.sourceforge.net and the new accepted methods are: SFTP, SCP, rsync over SSH. Unfortunately web.sourceforge.net also has a restricted shell environment and does not allow remote commands to be executed.

In addition shell access to shell.sourceforge.net now requires the creation of a shell before it can be accessed.

Both of these mean that if you attempt to deploy your site without following these steps you will get an error.

Quick Start

Create a shell on shell.sourceforge.net with your username and project group

ssh -t <username>,<project name>@shell.sf.net create

Use shell.sourceforge.net (instead of web.sourceforge.net) in you site URL

Verify that you have a working web site by opening a browser to http://your_project.sf.net

Detailed Instructions with Examples

The following examples will use the qifcon project and the user barrie. Substitute these with your own project name and user name.

Create a shell on shell.sourceforge.net with your username and project group

$ ssh -t barrie,qifcon@shell.sf.net create
barrie,qifcon@shell.sf.net's password:
Requesting a new shell for "barrie" and waiting for it to start.
queued... creating... starting...
This is an interactive shell created for user barrie,qifcon.
Use the "timeleft" command to see how much time remains before shutdown.
Use the "shutdown" command to destroy the shell before the time limit.
For path information and login help, type "sf-help".
-bash-3.2$

Use shell.sourceforge.net (instead of web.sourceforge.net) in you site URL

No shell created error

If you try to run ssh without first creating a shell you will get the following error:

$ ssh barrie,qifcon@shell.sf.net
barrie,qifcon@shell.sf.net's password:
Logging in to your interactive shell...
You don't have an active shell at this time. For basic file transfers and
management, use web.sourceforge.net -- it allows rsync, sftp, and scp access.
If you would like to create a shell, use ssh to login using a USER,PROJECT
username with the "create" command. If you tell ssh to allocate a tty
(e.g. using -t), an interactive shell will be opened when the create is
done. Otherwise, the create command will exit when the shell becomes
ready for use. An example create that enters the shell when ready:
ssh -t USER,PROJECT@shell.sourceforge.net create
Connection to shell.sf.net closed.