Where Does Redmine Store Attachments and Config?
Redmine attachment folder and database config paths for package and manual installs on Linux servers.
Last updated
Redmine keeps uploaded files in a files folder inside its install root. Package installs on Debian use /usr/share/redmine with attachments under files beside config. Manual installs often sit at /var/www/redmine with the same internal layout.
Database settings live in config/database.yml with mail and attachment options in config/configuration.yml. Those two files decide where uploads actually go. Back up the files folder with both configs and a database dump. Attachments use hashed names that only make sense with the database.
Where Redmine stores this, by platform
/var/www/redmine/files
Default attachment root for manual installs. Debian packages symlink to /var/lib/redmine/files instead. Serve with web user ownership and keep off version control.
/var/www/redmine/config/database.yml
Holds database passwords and adapter settings. Restrict read access to root and the Redmine user. Copy with configuration.yml for a full settings restore.
Frequently asked questions
what do i back up for a Redmine migration
Copy the files folder with a database dump and the database.yml plus configuration.yml files. The files folder holds attachments by hashed names. Without the database the filenames mean nothing.
can Redmine store attachments outside the install folder
Yes. Set attachments_storage_path in configuration.yml to a shared path and point every node there. The database still tracks metadata. This suits multi server setups behind a load balancer.
Notice an outdated path? Let us know.