View source for Tutorial:Relocating and deleting cache and data

<languages/>

<translate>
<!--T:1-->
It is possible to relocate the [[data and cache directories]] to directories outside of their default location. This may be done for organizational purposes or for saving space on one filesystem by relocating them to a different filesystem.
</translate>

<translate>
<!--T:21-->
One can also delete these directories without relocating them. There are a few reasons why one would want to delete the cache and data directories:
</translate>

* <translate><!--T:22--> A general desire to save some space if the cache has gotten unexpectedly large.</translate>
* <translate><!--T:23--> Speeding up the [[local database]], as it will get slow if extremely large.</translate>
* <translate><!--T:24--> To solve some unexpected problem. If this is the reason for deletion, there is most likely an underlying issue that should be looked into instead, but sometimes deleting the database is a last resort potential solution.</translate>

<translate>
== Precautions == <!--T:2-->
</translate>

<translate>
<!--T:3-->
The data and cache paths are intertwined, and the [[local database]] uses absolute paths to reference the cache in places. <strong>Even if you only wish to delete the cache, both directories should be deleted to prevent dead database links</strong>. Deleting the data path will have a few side effects:
</translate>

# <translate><!--T:4--> You will be logged out. Ensure that you know your password and, if applicable, your [[2FA|two-factor authentication]] device is on hand.</translate>
# <translate><!--T:5--> Your [[Local Home]] will be cleared. Ensure that everything in there that you wish to save is backed up to the cloud.</translate>
# <translate><!--T:6--> Any local unsynced records will be deleted. If you are having sync issues and do not want to lose potential progress, see the [[sync errors]] page for help on resolving it before continuing.</translate>
# <translate><!--T:29--> Your [[machine ID]] will be reset</translate>
# <translate><!--T:30--> You will have to do the tutorial again. This can be skipped using the <code>-SkipIntroTutorial</code> [[command line argument]].</translate>

<translate>
== Deleting cache & data paths == <!--T:25-->
</translate>

<translate>
<!--T:26-->
Deleting your cache and data paths is a simple process:
</translate>

# <translate><!--T:27--> Locate your cache and data paths. Information on how to find them is found on the [[data and cache directories]] page.</translate>
# <translate><!--T:28--> Delete the two folders.</translate>

<translate>
== Relocating cache & data paths == <!--T:7-->
</translate>

<translate>
<!--T:8-->
[[<tvar name="SteamArgs">File:Steam_launch_options.png|thumb|right</tvar>|An example of custom launch options where the cache path is relocated to <code>D:\Temporary files\ResoniteCache</code>.]]
</translate>

<translate>
<!--T:9-->
For the Steam build, the relocation process is as follows:
</translate>

# <translate><!--T:10--> Navigate to Resonite in your Steam library</translate>
# <translate><!--T:11--> Click the gear icon to the right underneath the banner, then choose "Properties..."</translate>
# <translate><!--T:12--> In the "Launch options" section, there is a text box for custom launch options.</translate>
#* <translate><!--T:13--> To change the data path, add the text <code>-DataPath C:\Path\To\New\Data\Folder</code></translate>
#* <translate><!--T:14--> To change the cache path, add the text <code>-CachePath C:\Path\To\New\Cache\Folder</code></translate>
#* <translate><!--T:15--> If the path contains a space, it must be surrounded by double quotes, such as <code>-DataPath "D:\Example Path\With Spaces"</code></translate>
#* <translate><!--T:16--> Both options can be specified in the same textbox so long as they are separated by a space.</translate>
# <translate><!--T:17--> Close the window to save changes.</translate>
# <translate><!--T:18--> Delete the old cache and data directories. To find where these directories are, see the [[data and cache directories]] page.</translate>

<translate>
<!--T:19-->
If launching Resonite outside of Steam, then these options are appended to the command line of the <code>Resonite.exe</code> executable that you run.
</translate>

<translate>
<!--T:20-->
These arguments must be present at all times or else Resonite will revert back to the default directories.
</translate>

== <translate>Quick Reference</translate> ==

<code>-DataPath C:\Path\To\New\Data\Folder -CachePath C:\Path\To\New\Cache\Folder</code>

[[Category:Troubleshooting{{#translation:}}]]