1. Summary
  2. Files
  3. Support
  4. Report Spam
  5. Create account
  6. Log in
Version 61 (modified by brondsem, 3 years ago)

Update release notes section

Release Files for Download (FRS)

SourceForge.net provides a File Manager as a means for projects to make files available for download by their users. In addition to the web based File Manager, SourceForge provides an interactive-shell service for managing files. The File Manager and the interactive shell service provide different methods to manipulate the same files and folders. See Accessing Releases via Shell later in this document for more information.

Files released using the FRS are automatically distributed to our worldwide network of download mirrors, ensuring file availability, and providing great download performance to users.

Note: All file releases should be a single file. Multiple files for the same release should be archived together (tar, deb, zip, etc.). We recommend using rsync for all uploads over 20 megabytes in size, as rsync allows for resuming canceled or interrupted transfers.

Note: Allowed characters for files and directories are: -_ +.,=#~@!()[]a-zA-Z0-9 (including " " - space). Disallowed characters are: &:%?/*$ Filenames may not start with a space or dot ("."), and may not end with a space (" ").

You must be a project admin or have the "release technician" permission to manage files for a project. There are several ways to manage your files:

File Manager (Web)

Select Files from the Project menu. This is both the file manager (for admins) and the file browser (for visitors).

  • To create a folder, click Add Folder
  • To upload a file, click Add File
    • click Browse, and select your file(s)
    • click Upload
  • To rename a file or folder, click the "i" icon and edit the name.
    • Note: download statistics are based on file name, so stats for this file will be reset. Your total project download count will include the previous name's stats.
  • To delete a file or folder, click the "-" icon
    • Note: Users are responsible for backing up all of their files. SourceForge.net will not restore individual files.
  • To change file details, click the "i" icon
    • "Exclude stats" will omit this file from being counted in the download statistics
    • "Default download for" controls which file is the recommended download for visitors, based on their OS. If not set for any file in the project, heuristics are used to automatically pick a recent upload with an appropriate file extension for the OS.


User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

scp file.zip jsmith,fooproject@frs.sourceforge.net:/home/frs/project/f/fo/fooproject/Rel_1


User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

rsync -e ssh file.zip jsmith,fooproject@frs.sourceforge.net:/home/frs/project/f/fo/fooproject/Rel_1/


User jsmith seeks to put file.zip to the Rel_1 directory of his project, fooproject:

$ sftp jsmith,fooproject@frs.sourceforge.net
Connecting to frs.sourceforge.net...
jsmith,fooproject@frs.sourceforge.net's password: 
sftp> cd /home/frs/project/f/fo/fooproject/Rel_1
sftp> put file.zip
Uploading file.zip to /home/frs/project/f/fo/fooproject/Rel_1/file.zip
ws                                            100% 1573     1.5KB/s   00:00    


Developers may use the Shell service to manage existing files and folders.

Log into the Shell service then your change directory based on your project UNIX name (Example project named "fooproject"):

cd /home/frs/project/f/fo/fooproject

File management service

Release notes

The file browser will show any README file it finds in the current folder (or parent folder) below the file listing. This is useful to provide release notes, download instructions, etc. See here for more details

Old per-file release note associations are still accessible by clicking on the "i" icon.

Known limitations

Moving files and creating of symlinks may be accomplished via the shell, but cannot be done with the web file manager.

Migration from package/release system

For projects that had releases available for download at the time of the change to the File Manager facility (July 2009), those files were migrated to logical folders. This is based upon the package & release names.

In addition to the folders created for migrated package and releases, an "OldFiles" folder was also created which contains files that were previously hidden. The "OldFiles" folder is not visible to users downloading files from your project. If you wish to make a file visible, simply move it to a different folder.

Getting Help