Adjust Local Cache Settings

  • Updated

You can adjust and view the LucidLink cache through the control panel or with the command-line interface 'lucid cache' and 'lucid config' commands. 

From the LucidLink Application Home screen select the desired filespace and click on the "Control Panel" tab. Type your password and select Open control panel.


Navigate to settings and local cache size. The default cache is 5GB and can be increased to 10TB.

It is best practice that the cache location be your fastest disk within a system, preferably a Solid-state drive (SSD) or Non-Volatile Memory Express (NVMe) see System Requirements.
Ensure you have sufficient free disk space available or change where your cache is stored on disk, please review how to link to your Filespace with a specific cache location.

It might make sense in certain configurations to relocate your cache to an alternate location.

The default location for your cache is within the client root-path which resides within a .lucid folder inside your user profile or home directory depending on your operating environment.

Reasons for moving your cache could be to dedicate a drive to your cache to increase the size for pinning files and folders or to benefit a workflow that requires additional space.

For Microsoft Windows and macOS systems please ensure your cache location drive is formatted as either Apple File System (APFS) or New Technology File System (NTFS) see System Requirements.
Ensure your alternate cache location remains accessible at all times.
If utilizing a removal-media, ensure that power management is set accordingly to stop the drive going to sleep and do not eject the drive while LucidLink client is connected.

Once you click Edit on the Cache Location field, you can begin to enter the Path to your desired location. On macOS most external drives will automatically mount in /Volumes/. You can enter this and the possible locations will be shown.


On Windows, you can begin typing a Drive Letter, such as C:\ and you will be shown the available directories. You can also grab the path to a folder from Windows Explorer, in the top bar.


Command-line interface

The "lucid cache" command can be used to see the current cache configuration and turn the cache on or off.

Usage: lucid cache [options]

Display cache information as well as control the cache
    [--info]              Display cache information
    --on                  Turn the cache on
    --off                 Turn the cache off
--drop Clear all evictable pages from the cache.
--size size Size of the cache in MiB

Cache status:

lucid cache

State: enabled
Backend writes: enabled
Page size: 257KiB
Maximum configured size: 2.93GiB
Current size on disk: 2.93GiB
Pinned size on disk: 0B
Available size for pinning: 2.34GiB
Remaining upload: 0B

Clear all evictable pages from the cache.:

lucid cache --drop

To change the cache size from the command line you need to use lucid config.

usage: lucid config --explain [--KEY1 --KEY2 ...]

Key:               DataCache.Size
Description:       Local data cache size. The default is 5GB. 80% of the size is available for pinning.
Value constraints: Min 100MB. Max 10TB. Supported units: MB, GB, TB.
Default value:     5GiB


Example: change lucid cache size to 10GB (applied once there are no remaining uploads)

lucid config --set --DataCache.Size 10G

Was this article helpful?

0 out of 0 found this helpful