File Storage
Storage Locations
WikiTraccs stores data on the workstation it is running on.
Note
This documentation is valid as of WikiTraccs v1.12.25, as some locations were consolidated in this release.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 WikiTraccs settings dialog, or via the appsettings.json
> AttachmentRegistryRootPath
property.
The attachment registry contains:
All downloaded Confluence 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 safely 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
In-progress 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
Chrome driver (chromedriver.exe)
- note: as of WikiTraccs 1.19.5
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).
Tip
Delete the whole HTTPS__WIKI.CONTOSO.COM folder to be asked to log in to Confluence again when starting your next migration. WikiTraccs will recreate the folder.
So, when your configured temp folder is C:\Users\USER\AppData\Local\Temp, and your Confluence base address is https://wiki.contoso.com, you would delete the C:\Users\USER\AppData\Local\Temp\WikiTracccs\HTTPS__WIKI.CONTOSO.COM folder.
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