File Storage

Storage Locations

WikiTraccs stores data on the workstation it is running on.

Attachment Registry

The attachment registry contains all attachments so far downloaded from Confluence.

The default storage location is the non-roaming AppData folder of the current user. On Windows this typically is C:\Users\user\AppData\Local, on Linux ~/.local.

You can change the attachment registry folder location via the appsettings.json > AttachmentRegistryRootPath property. See this section on how to change the folder path: Change storage folder pathes.

• Storage location for all downloaded attachments

  • example: AttachmentRegistryRootPath\<subfolders per Confluence site, user and pages>
  • storage requirement: ⚠️ as much space as the accumulating attachments of migrated pages need
  • note: you can delete folders and files from the attachment registry subfolders; WikiTraccs won’t use them for anything else than uploading a page and its attachments to SharePoint; if files are missing, they will be downloaded again from Confluence

• Blob cache for migration-related data

  • example: AttachmentRegistryRootPath\wt-blobs.*
  • example: AttachmentRegistryRootPath\wt-users_*
  • storage requirement: usually < 10 GB

• Temporary storage location for attachment downloads (when using Selenium proxy option; note: non-standard configuration)

  • example: AttachmentRegistryRootPath\WtChromeDownloads
  • storage requirement: as much space as the biggest attachment
  • note: those attachments are moved to the Attachment Registry after downloading
  • note: this folder should ever only contain one file, because each file is moved immediately after being downloaded

Temporary Files

By default, temporary files are stored in the system’s temp folder. On Windows this typically is C:\Users\user\AppData\Local\Temp.

You can change the temporary folder location via the appsettings.json > TempPath property. See this section on how to change the temporary folder path: Change storage folder pathes.

Here’s what WikiTraccs stores at the temporary location:

Confluence Interactive Login Browser Profile

• Browser profile for Confluence login (with Cookie-based auth methods)
  • example target path: C:\Users\USER\AppData\Local\Temp\WikiTracccs\HTTPS__WIKI.CONTOSO.COM
  • storage requirement: size of a Chrome profile, ~2 GB

Note that USER is your Windows user’s profile name and HTTPS__WIKI.CONTOSO.COM will resemble your Confluence’s base address (with some special characters replaced).

Attachment Registry

• Temporary storage location for attachment downloads

  • example target path: C:\Users\user\AppData\Local\Temp\WikiTracccs
  • storage requirement: as much space as the biggest attachment
  • note: those attachments are moved to the Attachment Registry after downloading

• Storage of intermediary transformation files (XML)

  • example target path: C:\Users\user\AppData\Local\Temp\WikiTracccs
  • storage requirement: about ~100-500 KB per migrated page (depends on page content)
  • note: only if setting is enabled

Confluence Selenium Proxy Browser Profile

• Browser profile for Selenium proxy (only if activated; note: non-standard configuration)
  • example target path: C:\Users\user\AppData\Local\Temp\WikiTracccs\https__wiki.contoso.com\api-proxy
  • storage requirement: size of a Chrome profile, ~2 GB

User Profile Application Data

• WikiTraccs.GUI configuration file
  • local user profile, WikiTraccs folder, e.g. C:\Users\user\AppData\WikiTraccs\WikiTraccsGui_config.json
  • note: WikiTraccs < 1.12.25 used the temporary folder, e.g. C:\Users\user\AppData\Local\Temp\WikiTraccsGui_config.json
  • storage requirement: < 1 MB