####################
Application Settings
####################

Opening Application Settings
============================
To open the application settings click on the gear icon in the top-left corner of the application:
    .. image:: ../media/images/jetstream-menu-settings.png

The Settings Editor will appear.

.. _settings-editor-label:

Settings Editor
===============

.. image:: ../media/images/jetstream-settings.png

Application
-----------

.. _font-size-label:

Font size
"""""""""
Select the application font size. A restart of the application will be required if the size is changed from what is currently selected.

Hide welcome page at startup
""""""""""""""""""""""""""""
On startup, immediately show the :doc:`Send & Receive <../send/send-ui>` page instead of showing the Welcome Page.

.. _start-transfers-immediately-label:

Start transfers immediately on file drop
""""""""""""""""""""""""""""""""""""""""
This option affects the behavior of the :doc:`Send & Receive<../send/send-ui>` file browsers. When enabled, dropping paths onto a file browser will begin a transfer without first showing the :ref:`transfer-preview-label` window. When disabled, the :ref:`transfer-preview-label` window will be displayed. This option can also be changed from the Transfer Preview window.

Prevent computer from sleeping
""""""""""""""""""""""""""""""
Prevent the computer from going into sleep mode due to user inactivity while the application is running. This option is not supported on Linux.

Enable analytics
""""""""""""""""
This option affects whether the JetStream application will periodically send usage statistics to Jet Digital Inc. to assist in the improvemements of the product. Please consult the end-user license agreement (EULA) for restrictions on what can be sent.

Local Server
------------

Receive UDP Port
""""""""""""""""
Specify the UDP port that will be used by the :doc:`../locations/location-local` Location's server. The default is 0, which indicates the application will choose an available port each time it launches. This is sufficient in most cases, but may not work where transfers are received through a specific port through a router and/or firewall.

.. tip:: You may also need to configure your network router or firewall to forward UDP packets on this port, or enable NAT Traversal. Check with your network administrator.

If you specify a specfic *Receive UDP Port*, you cannot run multiple instances of the JetStream application, under the same user session, at the same time, as their ports will conflict.

.. note:: After you change this value, it will be necessary to restart the JetStream application for the new setting to take effect.

.. _router-nat-traversal-label:

Router NAT Traversal
""""""""""""""""""""
Specify if NAT traversal should be enabled or disabled. The default is *Disabled*.

When enabled, the JetStream application will ask compatible routers to open up the necessary ports. Both UPnP and NAT-PMP protocols are supported and one has to be enabled on the router for this to work.

.. note:: After you change this value, it will be necessary to restart the JetStream application for the new setting to take effect.


.. _troubleshooting-label:

Troubleshooting
---------------

Save server logs
""""""""""""""""

.. image:: ../media/images/jetstream-settings-troubleshooting.png

Write a server log for each session. Click on the *Logs location* link to view previously written logs.

Trace packets
"""""""""""""

Add packet tracing information to the server log.

.. note:: This increases the size of the log substantially, and may affect transfer performance.

.. note:: Changing *Save server logs*, and *Trace packets* requires an application restart to take effect.

Disable reads
"""""""""""""

Suppress file reads on the sender. This can be used to isolate file system bottlenecks.

Disable writes
""""""""""""""

Suppress file writes on the receiver. This can be used to test transfers without modifying the target file system or to isolate bottlenecks.
