- Confluence Docs 3.0 : Attachment Storage Configuration This page last changed on Mar 09, 2009 by ggaskell. Confluence allows you to store attachments in one of three places: Filesystem - locally in the Confluence home directory Database - in Confluence's configured database WebDAV - remotely on a WebDAV server (*deprecated*) A System Administrator can configure Confluence's attachment storage via the 'Attachment Storage' option on the 'Administration Console'. You need to have System Administrator permissions in order to perform this function. ## 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. The WebDAV attachment manager will be deprecated from Confluence 2.7, and will be removed from a later version of Confluence. If you store attachments on external WebDAV servers, we recommend that you migrate to file-system or database-backed attachment storage as soon as possible. Refer to CONF-9313 and CONF-2887. This DOES NOT affect the operation of the WebDAV plugin.
## 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'. To do this: Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open. 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
Important Directories and Files
Attachments: viewAttachmentStorage.jpg (image/jpeg) editAttachmentStorage.jpg (image/jpeg) migrationWarning.jpg (image/jpeg) editAttachmentStorage.jpg (image/jpeg) migrationWarning.jpg (image/jpeg)

Document generated by Confluence on Nov 05, 2009 23:26