Attachment Storage Configuration

By default Confluence stores attachments in the home directory (e.g. in a file system). 

To configure Confluence attachment storage:

  • Choose the cog icon , then choose General Configuration under Confluence Administration
  • Choose Attachment Storage

On this page:

Related pages:

Attachment Storage Options

Earlier Confluence versions allowed attachments to be stored in WebDav or the Confluence database. This is not an option for new installations. 

Local File System

By default, Confluence stores attachments in the attachments directory within the configured Confluence home folder.

Database (deprecated)

Confluence 5.4 and earlier gives administrators the option to store attachments in the database that Confluence is configured to use.

While storing attachments in the database can offer some advantages (such as ease of backup, and avoiding issues with some characters in attachment filenames), please be aware that the amount of space used by the database will increase because of greater storage requirements.

WebDav (deprecated)

WebDav is no longer available as an attachment storage option.  

This has no impact on your ability to configuring a WebDAV client to access spaces, pages or attachments in your Confluence site.

Migrating to a supported attachment storage option

If you are storing attachments in WebDav or your database, you can migrate to storing attachments in the file system. When migrating attachments from your database to a filesystem, the attachments are removed from the database after migration.

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.

To improve logging during the migration, add the package com.atlassian.confluence.pages.persistence.dao with level DEBUG. See Configuring Logging for more information.

To migrate, follow the steps below:

  1. Go to  > General Configuration > Attachment storage.
  2. Click Edit to modify the configuration.
  3. Select Locally in Confluence home directory
  4. Click Save to save the changes.
  5. 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.
    Screenshot: migration warning

The following external website provides further information on migrating attachments from database to file system storage that you might find helpful - https://www.scandio.de/blog/de/2013/05/confluence-attachment-migration-the-safe-way-2.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport