Shared Links
============

.. index::
  single: shared links
  see: link sharing; shared links
  see: shared tokens; shared links

.. program:: jetstream server

Shareable Links are one of the easiest ways to transfer files to someone else using JetStream, because the recipient does not need to know or have the server details or login credentials. The link encodes all necessary information, allowing JetStream to start the download with minimal fuss. Credentials of the user who created the link are never shared with the link recipients. The recipients only receive a token identifying the given link on the server.

When creating a shared link, the files that will be shared already have to exist on the server. Each shared link can have an expiry date, optional download limit, and optional passphrase. Expired links will be removed from the server within two hours of expiry.

.. note::
  If your server is running behind firewall, you may need to specify an :option:`--external-address`, so the client can generate correct links.

.. tip::
  If you wish to disable the shared links functionality, use :option:`--api-disable-shared-tokens`.

Shared links can be created using the :doc:`JetStream Client <jetstream-client:index>` or using the :doc:`JetStream API <jetstream-api:index>`.

.. seealso::
  * :doc:`/using_jetstream/jetstream_uri`
  * :doc:`jetstream-client:links/links-ui`
  * :meth:`~jetstream.sendinterface.SendInterface.createSharedToken`
  * :meth:`~jetstream.sendinterface.SendInterface.deleteSharedToken`
  * :meth:`~jetstream.sendinterface.SendInterface.getSharedToken`
  * :meth:`~jetstream.sendinterface.SendInterface.getSharedTokens`
