Confluence allows you to store attachments in one of three places:
A System Administrator can configure Confluence's attachment storage via the 'Attachment Storage' option on the 'Administration Console'.
|
|
Attachment Storage Options
Local File System
By default, Confluence stores attachments in the attachments
directory within the configured Confluence home folder. If you are looking to run Confluence Clustered, attachments must be stored in the database.
Database
Confluence gives administrators the option to store attachments in the database that Confluence is configured to use.
Here are some reasons why, as an administrator, you may want to choose this storage system:
- Ease of backup.
Avoiding issues with certain characters in attachment file names.
While storing attachments in the database can offer some advantages, please be aware that the amount of space used by the database will increase because of the greater storage requirements.
WebDAV
Confluence also allows administrators to set an external WebDAV repository as the location for attachment storage.
![]() | WebDAV attachment manager deprecated The option to store Confluence attachments on a WebDAV server has never worked in a useful fashion, and has not been maintained for many versions.
|
Migration between Attachment Storage Systems
You can 'migrate' your attachments from one storage system to another. All existing attachments will be moved over to the new attachment storage system.
![]() | When the migration occurs, all other users will be locked out of the Confluence instance. This is to prevent modification of attachments while the migration occurs. Access will be restored as soon as the migration is complete. |
![]() | When migrating attachments from your database to a filesystem, the attachments are removed from the database after migration. However, when migrating attachments from a filesystem to your database, the attachments remain on the filesystem after migration. If you wish to change this function's behaviour from 'copy' to 'move', please see CONF-14802 and cast your vote. |
To perform a migration, follow the steps below:
-
Go to the Confluence 'Administration Console':
- Choose Browse > Confluence Admin. The 'Administrator Access' login screen will be displayed.
- Enter your password and click Confirm. You will be temporarily logged into a secure session to access the 'Administration Console'.
- Click 'Attachment Storage' in the left-hand panel. The current configuration will be displayed.
Attachment storage configuration - Click the 'Edit' button to modify the configuration.
- Select the storage system you desire.
Edit attachment storage - Click the 'Save' button to save the changes.
- A screen will appear, asking you to confirm your changes. Clicking 'Migrate' will take you to a screen that displays the progress of the migration.
Migration warning
Troubleshooting
To enable debug logging for WebDAV attachment storage, add the following to the bottom of WEB-INF/classes/log4j.properties
and restart Confluence:
log4j.logger.com.atlassian.confluence.pages.persistence.dao=DEBUG,confluencelog log4j.additivity.com.atlassian.confluence.pages.persistence.dao=false log4j.logger.org.apache.webdav=DEBUG,confluencelog log4j.additivity.org.apache.webdav=false
RELATED TOPICS
No content found for label(s) data-storage. |
Attachments:




