Files

Attach files to project versions and manage the project file repository in Redmine.

The Files module provides a project-level file repository for distributing releases, binaries, and other downloadable assets. Files are attached to versions (milestones) of a project.

Enabling the files module

1. Go to Project → Settings → Modules.
2. Check Files.
3. Click Save.

A Files link appears in the project sidebar.

Understanding versions and files

In Redmine, downloadable files are attached to versions. Versions act as milestones (for example, v1.0, v2.0-beta). Before uploading files, you need at least one version defined for the project.

1. Create a version

   Go to Project → Settings → Versions and click New version. Enter a name, optional due date, and optional description.

2. Open the files list

   Click Files in the project sidebar.

3. Add a file

   Click Add.

4. Select the version

   Choose the Version that the file belongs to from the drop-down list.

5. Upload the file

   Click Choose file to select a file from your computer.

6. Save

   Click Add. The file appears in the files list under its version.

Files list

The files list groups files by version and displays:

• File name and size
• Upload date and uploader
• SHA-256 and MD5 checksums for download verification
• Download count

Use the checksum values to verify file integrity after downloading, especially for release packages.

Managing files

Deleting a file

Click the delete icon next to a file to remove it from the project. This action requires the manage_files permission and cannot be undone.

Browsing by version

Files are grouped by version in the list. Older versions remain visible in the list unless deleted, allowing users to download previous releases.

Multiple files per version

You can attach multiple files to the same version. This is useful for distributing multiple build targets (for example, Windows installer, Linux tarball, macOS disk image) for a single release.

Difference between Files and Documents

Feature	Files	Documents
Primary purpose	Release distribution	Knowledge base
Organisation	By project version	By administrator-defined category
Metadata	Checksum, download count	Title, description, custom fields
Typical content	Binaries, archives, installers	Specs, user guides, reports

Use Documents for internal documentation that team members need to reference, and Files for distributing versioned releases to end users.

Permissions

Action	Permission required
View files	view_files
Manage files (upload, delete)	manage_files