########
Synopsis
########

**teamdrived** [options] (autostart | shutdown)

.. _teamdrived-options:

#######
Options
#######

This is a list of known settings or command line arguments that are used by TeamDrive.

The majority of these settings can also be added to **[Settings]** Section of , 
the ``teamdrive.settings`` file located in the :option:`teamdrived --teamdrive-home` 
folder, which typically ``~/.teamdrive`` on Linux or Mac OS and ``%APPDATA%\TeamDrive3`` on 
Windows.

This is a valid ``teamdrive.settings`` file that sets two settings on Linux:

.. code-block:: ini

    [Settings]
    language=en-US
    spaces-path=/home/teamdrive/Spaces

And this is the corresponding settings file for Windows:

.. code-block:: ini

    [Settings]
    language=en-US
    spaces-path=C:/Users/TeamDrive/Documents/Spaces

Please note the usage of slashes instead of backslashes on Windows. Also notice that a
setting in the ``teamdrive.settings`` file is not prefixed by two dashes (``--``).

Local Installation Settings
===========================

.. program:: teamdrived

.. option:: --spaces-path

    Default path for newly created Spaces by the user.

.. option:: --teamdrive-home

    Set TeamDrive application data path. Typically ``~/.teamdrive`` on Linux or Mac OS
    and ``%APPDATA%\TeamDrive3`` on Windows.

.. option:: --data-path

    Default location for temporary data and cache files. Defaults 
    to :option:`teamdrived --teamdrive-home`

.. option:: --default-server

    Default host server to create spaces on

.. option:: --perform-backup=true/false (default: true)

    Enable / Disable creation of Backups

.. option:: --backup-path

    Set the Backup path
    
.. option:: --language

    Set the user interface language
    
.. option:: --autostart-delay

    Delay background tasks to speedup system startup time

.. option:: --working-set-size

    Maximum cache size

.. option:: --enable-folder-decoration=true/false (default: true)

    Enable / Disable file system folder decoration
    
.. option:: --enable-create-favorite-link-to-spaces=true/false (default: true)

    Windows only: creates a shortcut in the Windows explorer favorites to the :option:`teamdrived --spaces-path` folder.

.. option:: --device=<device>
    
    if *device* is "softwarecontext", TeamDrive will use the QtQuick2dRenderer as the rendering backend (Windows only)

.. option:: --enable-multi-processes=true/false (default: false)

    Allow spawning of multiple TeamDrive instances.

.. option:: --enable-shell-extension=true/false (default: true)

    Enables or disables the Windows Explorer integration or the Finder Extension.

    .. versionadded:: 4.1.2
    
.. option:: autostart

    Don't show the main window.

.. option:: shutdown

    Shutdown the currently running TeamDrive process.
    
Registration Server Communication
=================================

.. program:: teamdrived    
    
.. option:: --check-for-updates=true/false (default: true)

    The TeamDrive Client will check for software updates on the Registration
    Server. Set this value to false, if a software distribution tool will be used
    to deploy Client installations to your users.

.. option:: --auto-accept-invitation=true/false (default: false)

    When set to true, the TeamDrive Client will accept all Space invitations
    automatically and join these Spaces.

.. option:: --auto-accept-invitation-mode (default: archived)

    The mode of operation when joining Spaces automatically. Possible values are:
    current-version-only, all-versions, directory-information-only,
    no-sync-to-filesystem, offline-available, archived.

.. option:: --auto-invite-users=list

    A list of user names to be automatically invited into newly created Spaces
    with specified DefaultInvitationRights. The list has to be separated by
    semicolons and enclosed with double quotes in the settings file.
    Example: auto-invite-users="abc;def"

.. option:: --enable-key-repository=true/false (default: true)

    Enable / Disable the Key Repository.
    
Synchronization Settings
========================

.. program:: teamdrived

.. option:: --default-file-permissions

    Default unix file permissions. Default is 644. 

.. option:: --default-dir-permissions

    Default unix directory permissions. Default is 755.

.. option:: --scan-enabled=true/false (default: true)

    On startup, the internal database will be compared with the file system using a file
    system scan to detect Space changes while TeamDrive was not running.

Agent Settings
==============

.. program:: teamdrived

.. _teamdrived-http-api-port:

.. option:: --http-api-port=<host>

    where `<host>` equals one of the following:

    #. a port number (e.g. ``45454``)
    #. an IPv4 address including the port number (e.g. ``127.0.0.1:45454``)
    #. an IPv6 address including the port number (e.g. ``[::0]:45454``)
    #. a pipe or socket name. Requires ``http-api-type=local``.

.. option:: --http-api-type

    Sets the type of the HTTP API.

    #. ``local``: Opens a Named pipe on Windows or a Socket file on Linux
    #. ``tcp``: Opens a TCP port.
    #. ``ssl``: Opens a SSL/TLS encrypted TCP socket. See :option:`teamdrived --http-api-private-key` and
       :option:`teamdrived --http-api-certificate`

.. option:: --http-api-certificate

    SSL-Server only: A path to a certificate file for the api (PEM format).

.. option:: --http-api-private-key

    SSL-Server only: A path to a RSA private file for the certificate (PEM format). See
    also :option:`teamdrived --http-api-certificate`.

.. option:: --idle-shutdown-timeout

    The number of idle seconds, until the TeamDrive Agent shuts itself down. Typically used
    with automatically shutdown of Linux containers. Default: no timeout.
    
    .. versionadded:: 4.1.1    
    
.. option:: --http-api-external-register-url

    This url will be used to show a "Register Now" link in the Web UI. This setting is mainly useful for Web Portals.
        
    .. versionadded:: 4.1.1    

.. option:: --http-api-external-login-url

    This url will be used to redirect the Browser if a login is required. This setting is intended to be used for external authentication.
        
    .. versionadded:: 4.1.1    

.. option:: --http-api-compress-replies=true/false (default: true)

    Use a zipped HTTP content-encoding for JSON replies.
        
    .. versionadded:: 4.1.1    

.. _platform-specific-settings:
    
Platform specific Settings
==========================

It is possible to limit a setting to a specific domain. For example if you add -linux to a setting, this setting will only affect Linux clients.

+-----------+----------------------------+
|Suffix     |Description                 |
+===========+============================+ 
|-mac       |Mac OS X only.              |
+-----------+----------------------------+
|-win       |Windows only.               |
+-----------+----------------------------+
|-linux     |Linux Clients only.         |
+-----------+----------------------------+
|-agent     |Used by the Headless Agent. |
+-----------+----------------------------+