Collecting LucidLink Client Logs

Team LucidLink
Team LucidLink
  • Updated

From time to time issues happen. When liaising with LucidLink Support, you might be asked to collect and provide the client logs. 

The most efficient method is to upload a Diagnostic Report and provide the accompanying 'Reference ID' with your Support Ticket.

To locate your logs yourself it is specific to the operating system environment as to where these resources are located.

Default LucidLink Filespace cache and configuration `root-path` locations are located in the `user profile` or `home folders` as hidden '.lucid' sub directories and potentially within an 'instance_<id>' sub folder if you have multiple Filespaces linked.

Within this directory is the 'Lucid.log' file and 'app.log'.

To view the contents of your Lucid.log based on your operating system you can open it within a text editor: 


Windows: accessible through Explorer or command line.

    1. Launch File Explorer


    2. Navigate to C:\Users and select your User profile directory

    3. Locate the .lucid folder and upload Lucid.log and app.log


Alternative Windows core or via command-line:

notepad.exe C:\Users\%username%\.lucid\Lucid.log
notepad.exe %userprofile%\.lucid\Lucid.log

Location of Lucid.log when running as a Windows as a Service.



macOS: available within Finder or via terminal.

    1. Launch Finder


    2. Select the Go menu and Home 


    3. Once within Home press press Command + Shift + . (dot) to expose the hidden .lucid folder

On macOS the .lucid folder is a hidden folder, which means that you may have to press Command + Shift + . (dot) when viewing the user home directory in Finder

    4. Locate Lucid.log and app.log to attach to your support ticket


Alternatively via Terminal

open -e $HOME/.lucid/Lucid.log
open -e ~/.lucid/Lucid.log


Linux: via terminal or file browser.

1. Launch your File Browser and navigate to Home, within you will find a .lucid folder and subsequent Lucid.log and app.log files to attach to your support ticket.  


Open Lucid.log via Terminal

vi ~/.lucid/Lucid.log

It might make sense to copy the Lucid.log to the Desktop:

cp ~/.lucid/Lucid.log ~/Desktop/Lucid.log

Note: an 'app.log' file located within the root '.lucid' folder, sometimes we might request this additional file.

If the log file has grown to a size not suitable for the traditional transport methods (email/upload) please compress (.zip/.rar) as compaction will dramatically reduce this file for easier handling.

In certain situations under increased log entries our logs rotate and you will notice additional Lucid.log*.gz files - we will require all associated *.gz files.

Identify your Filespace `root-path`

lucid status


Was this article helpful?

2 out of 3 found this helpful

Have more questions? Submit a request



Article is closed for comments.