Files

Note: We are working on updating our documentation, this page has been identified as still needing improvement. This notice will be removed once these improvements are complete.

Using our Web-based File Manager

Our new File Manager lets you upload and manage your project files that are available for downloading by the public. If the web-based client is not for you, you can also SSH directly into our file servers.

Requirements

  • File size: 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. Read more about how to do this on our Shell Services page.
  • You must be a project admin or have the "release technician" permission to manage files for a project.
  • 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 (" ").

Using the Web Interface

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
Clicking on the "i" icon enables your visitors to see more information about the file, such as SHA1 and MD5 hashes, how many times the file has been downloaded, and whether or not it is the default distribution for an OS. As a project admin, you can also click this icon to edit information about the individual file.

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.
"Download button" allows you to change the label on the download button seen by your visitors.

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. and it is highly recommended you make this available to your end users. 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.

Archiving old releases

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.


Related

Documentation: Docs Home
Documentation: File Management
Documentation: Mirrors
Documentation: Release Files for Download
Documentation: SSH
Documentation: Shell Services
Documentation: ToC