Tresorit’s simple command-line interface runs on headless Linux workstations or servers. Compared to the graphical Tresorit client, it provides a limited feature set that can be used to automate tasks like sync and reporting in a way that best suits your needs.
📝 Note: Earlier the parent folders in Tresorit were called tresors. While you won't see this wording any more on the user interface, the commands in this documentation will use it. Tresor refers to the parent folders which you will see in the All Files view of your Tresorit account. Directory refers to subfolders which are under your parent folder in your folder structure.
Tresorit Linux executables
The Tresorit installer provides three executables (x86 and x64): (the GUI), (the CLI) and (the Daemon). The runs as a daemon process. Both the GUI and the CLI can start and connect to the Daemon. If you wish, you can start the Daemon manually, or with an init script by executing the binary without any arguments.
On start, the Daemon performs autologin if it has been enabled.
When the Daemon is running, it will continue all operations it has been directed to do (synchronizing tresors, serving the Tresorit Drive, etc.) and it can automatically update itself without the need for either GUI or CLI interaction. This means that after configuring the Daemon with either the GUI or the CLI, it is sufficient to just start the Daemon on startup to automatically login and continue all sync and drive operations.
CLI - GUI interoperability
The GUI and the CLI can be used simultaneously and they will execute commands on the same Daemon instance.
If the Daemon is already running when the GUI starts (because it has been started manually or by the CLI), the GUI will connect to it, and when the GUI is closed, it will prompt you whether you want to shut the Daemon down along with it. Otherwise, if the Daemon is not yet running when you start the GUI, the GUI will automatically start it, and when the GUI is closed, it will close the Daemon without prompting you.
Using the CLI
Running the CLI
Theexecutable can be found in the client's installation path (the default is ). You can run the CLI by either changing to this directory and executing the :
Or by adding the client's installation path to yourenvironment variable and running the command. This can be done by adding
to your shell's rc (.bashrc, .zshrc, ...)
You can start the Daemon by executing
which is equivalent to starting themanually.
You can stop the Daemon by executing
which is equivalent to sending asignal ( ) to the .
If no subcommand is specified, using theoption lists all built-in subcommands.
Using theoption with a subcommand displays a help string about the subcommand and lists its options.
Normally the CLI displays lists and tables nicely formatted and padded with spaces.
If this is not desired, e.g. for scripting purposes, every command has aoption which generates easily parsable, machine-friendly output, separated by single tabs.
Parent folder (tresor) names and ids
When specifying a parent folder, you can usually use its name. However, multiple parent folders with the same name can exist. In this case, you have to use an unambiguous ID which is available in thelisting (parent folders with the same name will have an ID postfixed in a format.
This is the same format that is used in Tresorit Drive for handling multiple parent folders with the same name, and therefore you can also use the Tresorit Drive to find out which parent folder you want to specify. Using the Tresorit Drive for this purpose has the added benefit of being able to match the folders' name and ID with its contents.
With this command you will receive a status report on the Daemon, Tresorit Drive and if there’s an active Tresorit session.
Use this command to define the proxy settings for your Tresorit client. Depending on your network configuration, you may need to apply custom settings to succesfully login and use Tresorit.
With the login command, you can sign in to Tresorit from the command-line client, using your email, password and other authentication options you previously set up in your account.
Sign out of Tresorit with an option to unlink or even wipe synced files from the device you are using at the moment.
Create parent folder (tresor)
Use this command to create a new parent folder (tresor). The output of this command will contain the name and id of the new parent folder (tresor).
Create subfolder (directory)
Use this command to create a new directory in a parent folder (tresor). Please note that the parent folder (tresor) or a parent directory must exist.
List parent folders (tresors)
When you enter the list tresors command, you will receive a list of your parent folders (tresors) in the cloud with useful information such as their sync status and location on your computer.
Start and stop syncing
With this command, you can start or stop syncing a parent folder (tresor). Tresorit will remember this setting upon restart.
Mount or unmount drive
Use this command to enable or disable Tresorit Drive on your computer. Tresorit will remember this setting upon restart.
The following packages have to be installed:
fuse (and libfuse2)
- apt-get install fuse libfuse2
- zypper in fuse libfuse2
- emerge sys-fs/fuse
Show sync transfers per parent folder (tresor)
When you enter the transfers command, you will receive a list of a parent folder's (tresor’s) sync status: it will show if it is syncing at the moment and if so, it will include the number of files left and if are there any errors.
Create file request link
📝 Note: File request related features are not supported in the Linux GUI, but they are enabled via the CLI.
Use this command to create a new file request link. The output of this command will contain the settings of the new file request link.
Modify file request link
Use this command to modify the settings of an existing file request link. Please note that omitting any parameter will leave the corresponding setting unchanged.
The output of this command will contain the settings of the modified file request link.
Revoke, remove file request link
Use this command to revoke or remove a file request link. Please note that the file request link must be revoked to be able to remove it.
List file request links
With this command you will receive a list of file request links. The output of this command will contain the status of the file request links. You can use this command to find the id of the existing file request links.
List file request link pending files
With this command you can list the pending files of a file request link. The output of this command will contain the status of the pending files. You can use this command to find the id of the pending file request link files.
Accept, discard file request link pending files
You can use this command to accept or discard pending file request link files. The output of this command will contain the names of accepted/discarded files.
Download file request link pending files
You can use this command to download pending file request link files to your file system. The output of this command will contain the names of downloaded files.
Log and metrics settings
Use this command to enable or disable log sending and metrics. If you encounter an issue, our support team may ask you to submit your logs to speed up the investigation.
Still have questions left? Drop us a line