Filesystem store

Version 2.1 by Thomas Mortagne on 2024/05/22
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

By default in XWiki the content of attachments and deleted attachment and documents are stored in what we call the "filesystem store". By default it's located in <permanentdir>/store/file.

It's a simple file based storage in which documents and attachments references are (md5) hashed, to avoid problems with various limited (in terms of encoding and path size) file systems.

For example the attachment XWikiLogo.png in document Sandbox.WebHome is stored in the following location: /1/0/5d42329a923e687f5dff4887d80098/attachments/9/2/0bc685fa0da28168319c0126def81b.

And where is my entity located ?

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:Documentation.AdminGuide.Store.Filesystem.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Failed to execute the [groovy] macro. Cause: [The execution of the [groovy] script macro is not allowed in [xwiki:Documentation.AdminGuide.Store.Filesystem.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Attachments and deleted attachments

By default, inside the attachment folder, you will find both the current version of the attachment and its history. The file name is always f, it's then optionally followed by the version (when it's a piece of the history) and the original file extension.

  • f.png
  • fv1.1.png
  • fv2.1.png

XWiki 16.4.0+ Most of the time, instead of the current version of the attachment, a "link" is created. It's a file named f.lnk which contains the relative path it's representing. In standard condition, it always points to the latest version of the attachment.

  • f.png.lnk Informationcontains the string fv2.1.png
  • fv1.1.png
  • fv2.1.png

Deleted attachments

Deleted documents

Get Connected