Configuring the global default settings for a filespace can help ensure a uniform experience for your workspace members. While in most circumstances the defaults are sufficient, it is important to understand the many configurable options that are built into the service to improve both the performance and the overall experience while using LucidLink. Taking advantage of global default settings can also lessen the overhead on administrators and IT managers when deploying LucidLink to their teams. 

Those familiar with the filespace settings available in LucidLink Classic can find many of the same settings in the new LucidLink as of a product update released on March 19, 2025. The LucidLink web application provides this product update automatically with no action required on the part of the administrator or end user. If however you are running a version of the LucidLink 3.0 desktop client released prior to this date, please update your desktop client to the most current version available found here.

Getting started with the filespace settings global defaults

Open your LucidLink desktop client application, navigate to the LucidLink workspace needed, and select the relevant filespace from the list of available filespaces found on the left hand side of the client. You can then use the drop-down menu and select "Filespace settings" to access the available settings.

Global settings are accessible from within both the new LucidLink web application as well as within the new LucidLink desktop client. Global settings can be viewed only by account owners and administrators, but not by a standard user. Note that local settings are accessible only from the LucidLink desktop client, and not accessible from the LucidLink web application. 

Currently available filespace settings

The product update released on March 19, 2025 provides these commonly used settings directly in the desktop client and the web application (depending on the user type). More settings are available in LucidLink version 3.0 by using the command line interface, explained in the section below. Note that some of these settings are accessible only from within the global settings. 

• Cache location This allows users to change the location of their LucidLink data cache. This setting is only available as a local setting, and can only be changed within the desktop client (i.e. not available within the web application)
• Cache size This allow users to control the size of their local cache. The default is 25GiB, with 80% of the size available for pinning. The maximum cache size is 10TiB.
• Mount point per OS (Windows, macOS, Linux) This defines the path which will be used as a mount point. (e.g. "/Volumes/domain/filespace" on macOS, C:\Volumes\domain\filespace or a drive letter (e.g. L:) on Windows)
• ForbidSpecialCharacters (global-only) This setting allows an administrator to forbid or to allow creating file names which are not compatible with the Windows operating system. These are names containing a special character \/:*?"<>| , have a trailing space or dot, or represent a reserved name on Windows.
• LockingExtensions (global-only) This setting defines which file types, as defined by their file type extension, allow for file-locking when that file type is open by an end user. Currently this feature is available only on the Windows operating system. Adobe InDesign, however, does support file locking on the macOS platform.

Learn more

To learn more about administrating filespace settings and global default settings, please see this instructional video found here. 

Managing global defaults via the LucidLink command line

Global default settings can be managed from the new web application, the new desktop client, and also from the LucidLink command line interface.

Using the command line interface requires being signed in to LucidLink as the account owner or as the administrator, and can be done from the Command prompt/PowerShell when on the Windows operating system, or from within the Terminal interface when on macOS or Linux. 

To use the command line interface to adjust global settings, first open the LucidLink desktop client application and make sure you are connected to the filespace in question. 

Next, open the command line interface, or CLI (Applications -> Utilities -> Terminal for macOS, or Command Prompt/Powershell for Windows). 

To see all available configuration options, you can run the following command.

lucid config

Here you will see the current list of global settings and whether they are default or have been changed. Making changes to any of these settings will affect all new users, as well as any users currently using the default settings on their client.

If you need an explanation on what a certain config does, you can run the following command, which will show a brief description on each:

lucid config --explain

First we'll cover Mount Points.  The Mount Point is how the Filespace volume is presented to each user's operating system.  It is usually best for all users to use the same mount point for each OS as this ensures file path consistency.  Many teams will never need to change this setting, but if you do for instance want your Filespace to mount as the X: drive on Windows, you can make that change here, by running the following command:

lucid config --global --set --FileSystem.MountPointWindows X:

Once you run the command, you will be asked to type in your workspace password. 

To change the macOS mount point, you can run the following command:

lucid config --global --set --FileSystem.MountPointOSX /Volumes/myFilespace

To change the Linux mount point, you can run the following command:

lucid config --global --set --FileSystem.MountPointLinux /media/myFilespace

Changing the default cache size will allocate more local cache for each user.  Even if you leave this at the default of 25GB, individual users can increase or decrease their local cache size to suit their needs. To change the cache size on a global level, you can run the following command (the example will set the cache size to 100 GB):

lucid config --global --set --DataCache.Size 100G

The Windows Global File Locking feature includes a default list of extensions.  If your team uses any file extensions not already included, you may add them using this setting.

lucid config --global --set --FileSystem.LockingExtensions idlk,db1,dw1,ppt

If you wish to reset the config to the default state, run the following command:

lucid config --global --delete --FileSystem.LockingExtensions

Maximum upload and download connections can be set via the following commands. By default each connected client uses up to 64 parallel connections up and down.  For most users these default settings will be best.  Only users with very high speed / low latency connections should consider increasing the number of connections, and conversely users on lower speed, high latency connections may want to decrease the number of connections.

lucid config --global --set --ObjectScheduler.MaxDownloadConns 128

lucid config --global --set --ObjectScheduler.MaxUploadConns 128