Tresorits einfache Befehlszeilenschnittstelle läuft auf monitorlosen Linux-Arbeitsstationen oder -Servern. Im Vergleich zum grafischen Tresorit-Client bietet diese eine beschränkte Funktionsauswahl, mit der Prozesse wie Synchronisation oder Berichterstattung Ihren Bedürfnissen entsprechend automatisiert werden können.
📝 Anmerkung: In der Vergangenheit wurden Hauptordner in Tresorit als Tresore bezeichnet. Zwar wird Ihnen dieser Begriff nicht mehr in der Benutzeroberfläche begegnen, aber die Befehle in der vorliegenden Dokumentation nutzen die Bezeichnung weiterhin. „Tresor“ bezieht sich auf die Hauptordner, die Sie in der „Alle Dateien“-Ansicht Ihres Tresorit-Kontos sehen. „Verzeichnis“ bezieht sich auf Unterordner, die sich in Ihrer Ordnerstruktur unterhalb des Hauptordners befinden.
Linux-Programmdateien für Tresorit
Der Tresorit-Installer bietet drei Programme: tresorit (die grafische Benutzeroberfläche=GUI), tresorit-cli (die Befehlszeilenschnittstelle=CLI) und tresorit-daemon (der Daemon). Der tresorit-daemon wird als Daemon-Prozess ausgeführt. Sowohl die GUI als auch die CLI kann starten und mit dem Daemon verbunden werden. Der Daemon kann auch manuell oder mit einem Skript gestartet werden. Führen Sie dazu die tresorit-daemon Binärdatei ohne Argumente aus.
Beim Starten führt der Daemon eine automatische Anmeldung durch, wenn diese aktiviert ist.
Wenn der Daemon läuft, führt er alle Operationen weiter aus, die ihm vorgeschrieben sind (Synchronisation der Hauptordnern (Tresore), Bedienung von Tresorit Drive usw.) und kann sich automatisch ohne GUI-oder CLI-Interaktion aktualisieren. Das heißt, dass es nach der Konfiguration des Daemons mit GUI oder CLI ausreichend ist, den Daemon einfach beim Systemstart zu starten, damit die automatische Anmeldung erfolgt und die Synchronisation und Laufwerkvorgänge weiterlaufen.
CLI - GUI Interoperabilität
GUI und CLI können gleichzeitig genutzt werden und führen Befehle auf derselben Daemon-Instanz aus.
Falls der Daemon bereits beim Starten von GUI läuft (da er manuell oder per CLI gestartet wurde), wird GUI sich mit ihm verbinden und wenn GUI geschlossen wird, erscheint eine Anfrage, ob Sie Daemon mit GUI zusammen schließen möchten. Wenn der Daemon beim Starten von GUI noch nicht läuft, wird er von GUI automatisch gestartet, und wenn GUI geschlossen wird, wird der Daemon ebenfalls ohne Anfrage geschlossen.
Nutzung von CLI
Tresorit für Linux benötigt X11-Bibliotheken, die auf neueren Wayland-basierten Distributionen möglicherweise fehlen. Prüfen Sie, welche X11-Pakete Ihre Distribution benötigt. Für Ubuntu 25.10 und höher empfehlen wir die Installation der folgenden Pakete:
- libxcb-icccm4
- libxcb-image0
- libxcb-keysyms1
- libxcb-render-util0
- libxcb-xkb1
- libxkbcommon-x11-0
Wenn diese Bibliotheken fehlen, startet Tresorit nicht. In diesem Fall können Fehlermeldungen wie folgende im Terminal erscheinen: error while loading shared libraries: libxcb-icccm.so.4: cannot open shared object file: No such file or directory.
CLI ausführen
Die tresorit-cli-Programmdatei ist im Installierungspfad des Clients zu finden (der Standard ist ~/.local/share/tresorit/). Sie können CLI ausführen, indem Sie in dieses Verzeichnis wechseln und tresorit-cli ausführen:
./tresorit-cli
Oder wenn Sie den Installierungspfad vom Client zum Ihrer PATH -Umgebungsvariablen hinzufügen und den Befehl tresorit-cli ausführen. Fügen Sie
export PATH="$HOME/.local/share/tresorit:$PATH"
zum rc Ihrer Shell (.bashrc, .zshrc, ...) hinzu.
Starten
Starten Sie den Daemon mit der Ausführung von
identisch mit dem manuellen Starten von tresorit-daemon.
Herunterfahren
Schließen Sie den Daemon mit der Ausführung von
identisch mit dem Senden eines TERM-Signales (kill) zum tresorit-daemon.
Hilfe
Nutzen Sie den Befehl --help, um sich eine Liste aller integrierten Built-in-Befehle anzeigen zu lassen.
Rufen Sie --help in Kombination mit einem Shell-Befehl auf, um sich eine Kurzbeschreibung des jeweiligen Befehls und dessen Optionen angeben zu lassen.
Porcelain
Normalerweise zeigt CLI schön formatierte, mit Leerzeichen angefüllte Listen und Tabellen an.
Wenn das nicht gewünscht ist, z.B. für Skriptzwecke, hat jeder Befehl eine porcelain-Option, die eine einfach lesbare, maschinenfreundliche Ausgabe erstellt, die mit einfachen Tabs aufgeteilt ist.
Namen der Hauptordnern (Tresornamen) und IDs
Wenn Sie einen Hauptordner angeben, können Sie dessen Namen nutzen. Da jedoch mehrere Hauptordnern unter dem gleichen Namen existieren können, müssen Sie eine eindeutige ID-Kennung nutzen, die in der tresorit-cli tresors-Liste verfügbar ist (Hauptordnern mit demselben Namen bekommen eine ID-Kennung in folgendem Format: "Tresor Name (ID)".
Das ist das gleiche Format, welches bei Tresorit Drive für die Handhabung mehrerer Hauptordnern mit dem gleichen Namen genutzt wird, so dass Sie auch Tresorit Drive nutzen können, um den Ordner zu finden, den Sie angeben möchten. Wenn Sie Tresorit Drive dafür nutzen, hat das auch den Vorteil, dass Sie den Namen des Hauptordners (Tresornamen) und dessen ID-Kennung mit seinem Inhalt abgleichen können.
Verfügbare Befehle
Status
Mit diesem Befehl erhalten Sie einen Statusreport über den Daemon, Tresorit Drive und über die Tresorit-Sitzung, falls eine aktiv ist.
Befehlssyntax
Proxy-Einstellungen
Nutzen Sie diesen Befehl, um die Proxy-Einstellungen für Ihren Tresorit-Client zu definieren. Abhängig von Ihrer Netzwerkkonfiguration müssen Sie die Einstellungen eventuell anpassen, um sich in Tresorit erfolgreich anmelden zu können.
Befehlssyntax
proxy --no-proxy
proxy --use-system-proxy
proxy --type <type> [--host <host>] [--port <port>] [--username <username>] [--password <password>|--password-on-stdin]
Parameter
no-proxy deaktiviert Proxy
use-system-proxy nutzt die Proxy-Einstellungen vom System in {https_proxy, all_proxy, http_proxy} Umgebungsvariablen
type Proxy-Typ
Mögliche Typen:
None
Http
Socks4
Socks4a
Socks5
Socks5h
host Hostname des Proxy
port
username Benutzername zur Authentifizierung
password Passwort zur Authentifizierung
password-on-stdin der Befehl wartet auf das Passwort, das zur Authentifizierung in der Standardeingabe genutzt wird
Anmeldung
Mit dem Login-Befehl können Sie sich in Tresorit vom Kommandozeilen-Client aus mithilfe Ihrer E-Mail, Ihres Passworts und anderer vorher eingestellten Authentifizierungsoptionen anmelden.
Befehlssyntax
]
Parameter
password
password-on-stdin der Befehl wartet auf das Passwort aus der Standardeingabe
dont-remember-me Wenn dies aktiviert ist, werden die Anmeldeinformationen nicht gespeichert, automatische Anmeldung ist nicht möglich
totp Einmaliges Passwort für 2-Stufen-Verifizierung
Abmeldung
Bei der Abmeldung von Tresorit können Sie das von Ihnen aktuell genutzte Gerät trennen oder sogar synchronisierte Dateien von diesem Gerät löschen.
Befehlssyntax
Parameter
wipe löscht lokal gespeicherte Anmeldeinformationen und synchronisierte Tresor-Inhalte
Hauptordner (Tresor) erstellen
Nutzen Sie diesen Befehl, um einen neuen Hauptordner (Tresor) zu erstellen. Die Ausgabe dieses Befehls wird den Namen und die ID-Kennung des neuen Hauptordners (Tresors) enthalten.
Befehlsyntax
Parameter
Verzeichnis erstellen
Nutzen Sie diesen Befehl, um ein neues Verzeichnis in einem Hauptordner (Tresor) zu erstellen. Die Ausgabe dieses Befehls wird den Pfad des neuen Verzeichnisses enthalten.
Befehlsyntax
Parameter
path der Pfad des Verzeichnisses, der bezüglich des Tresors erstellt wird
Hauptordner (Tresore) auflisten
Wenn Sie den Befehl ausführen, erhalten Sie eine Liste Ihrer Hauptordner (Tresore) in der Cloud mit nützlichen Informationen, wie deren Synchronisationsstatus und Zielort auf Ihrem Computer.
Befehlssyntax
Synchronisation starten und anhalten
Mithilfe dieses Befehles können Sie die Synchronisation für einen Hauptordner (Tresor) starten oder stoppen. Tresorit wird sich an die Einstellungen nach dem Neustart erinnern.
Befehlssyntax
sync --stop <tresor_name|tresor_id>
Parameter
path Pfad als Einbindungspfad des Hauptordners (Tresors) beim Starten der Synchronisation nutzen
stop Synchronisation für den Hauptordner (Tresor) mit der angegebenen Tresor-ID-Kennung oder dem Tresornamen, falls eindeutig, stoppen
Laufwerk einbinden oder Einbindung aufheben
Führen Sie diesen Befehl aus, um Tresorit Drive auf Ihrem Computer zu aktivieren oder zu deaktivieren. Tresorit wird sich an die Einstellungen nach dem Neustart erinnern.
Befehlssyntax
Parameter
unmount Einbindung von Drive aufheben
Synchronisationsstatus pro Hauptordner (Tresor) anzeigen
Nach dem Ausführen des Befehls erhalten Sie eine Liste über den Synchronisationsstatus eines Hauptordners (Tresors), die angibt, ob der Hauptordner (Tresor) aktuell synchronisiert wird und die Anzahl der Dateien und möglichen Fehler anzeigt.
Befehlssyntax
Parameter
files wenn dies aktiviert ist, werden statt einer Zusammenfassung die individuellen Dateiübertragungen angezeigt (Tresorname, Dateipfad, Statusfortschritt)
Link für Dateianforderung erstellen
📝 Anmerkung: Auf Dateianforderungen bezogene Features werden nicht in Linux GUI unterstützt, aber sind über die Befehlszeilenschnittstelle (CLI) aktiviert.
Nutzen Sie diesen Befehl, um einen neuen Link für eine Dateianforderung zu erstellen. Die Ausgabe dieses Befehls wird die Einstellungen für den neuen Dateianforderungslink enthalten.
Befehlssyntax
Parameter
path der Zielpfad (im Hinblick auf den Hauptordner (Tresor)) der Dateien des Dateianforderungslinks, falls diese angenommen werden
name der Name des Links für die Dateianforderung
verified falls angegeben, E-Mail-Verifizierung verlangen
expiration die Anzahl der Tage, für die der Dateianforderungslink aktiv sein wird
Link für Dateianforderung bearbeiten
Nutzen Sie diesen Befehl, um die Einstellungen eines bereits existierenden Dateianforderungslinks zu bearbeiten. Bitte beachten Sie, dass das Auslassen von Parametern dazu führt, dass die entsprechende Einstellung unverändert bleibt.
Die Ausgabe dieses Befehls wird die Einstellungen des bearbeiteten Dateianforderungslinks enthalten.
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
path der Zielpfad (im Hinblick auf den Hauptordner (Tresor)) der Dateien des Dateianforderungslinks, falls diese angenommen werden
name der Name des Links für die Dateianforderung
expiration die Anzahl der Tage, für die der Dateianforderungslink aktiv sein wird. 0 bedeutet kein Ablaufdatum
Link für Dateianforderung sperren/entfernen
Nutzen Sie diesen Befehl, um einen Link für eine Dateianforderung zu sperren oder zu entfernen. Bitte beachten Sie, dass der Link für die Dateianforderung gesperrt sein muss, um entfernt werden zu können.
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
Links für Dateianforderungen auflisten
Mit diesem Befehl werden Sie eine Liste von Dateianforderungslinks erhalten. Die Ausgabe dieses Befehls wird den Status der Dateianforderungslinks enthalten. Sie können diesen Befehl nutzen, um nach der ID-Kennung bereits existierender Dateianforderungslinks zu suchen.
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
open nur offene Dateianforderungslinks auflisten
pending nur offene Dateianforderungslinks mit ausstehenden Dateien auflisten
Ausstehende Dateien des Dateianforderungslinks auflisten
Mit diesem Befehl können Sie die ausstehenden Dateien eines Dateianforderungslinks auflisten. Die Ausgabe dieses Befehls wird den Status der ausstehenden Dateien enthalten. Sie können diesen Befehl nutzen, um nach der ID-Kennung der ausstehenden Dateien des Dateianforderungslinks zu suchen.
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
Ausstehende Dateien des Dateianforderungslinks annehmen/verwerfen
Sie können diesen Befehl nutzen, um ausstehende Dateien eines Dateianforderungslinks anzunehmen oder zu verwerfen. Die Ausgabe dieses Befehls wird die Namen der angenommenen/verworfenen Dateien enthalten
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
all alle ausstehenden Dateien annehmen oder verwerfen.
file-id ID-Kennungen der anzunehmenden oder zu verwerfenden Dateien. Erwartet eine durch Kommas getrennte Liste der File-ID-Kennungen.
Ausstehende Dateien des Dateianforderungslinks herunterladen
Sie können diesen Befehl nutzen, um ausstehende Dateien eines Dateianforderungslinks in Ihr Dateisystem herunterzuladen. Die Ausgabe dieses Befehls wird die Namen der heruntergeladenen Dateien enthalten.
Befehlssyntax
Parameter
id die ID-Kennung des Links für die Dateianforderung
download-path der Pfad, in dem die Dateien in Ihrem Dateisystem heruntergeladen werden sollen
all alle ausstehenden Dateien herunterladen
file-id ID-Kennungen der herunterzuladenden Dateien. Erwartet eine durch Kommas getrennte Liste der File-ID-Kennungen.
Einstellungen für Logdateien und Metrik
Mit diesem Befehl können Sie den Versand der Logdateien und Metrik aktivieren oder anhalten. Sollte Ihnen eine Störung widerfahren, bittet unser Support-Team Sie möglicherweise um die Logdateien für eine nähere Prüfung.
Befehlssyntax
logging --disable-metrics|--enable-metrics
logging --status
Parameter
enable-logs-sending aktiviert aggregierten Logversand
disable-metrics deaktiviert Metrik
enable-metrics aktiviert Metrik
status zeigt die aktuellen Log- und Metrikeinstellungen an