NAME

       onionshare  -  a  tool  for anonymously sharing files over a temporarily set up Tor Hidden
       service.

SYNOPSIS

       onionshare [options] filename

DESCRIPTION

       OnionShare lets you anonymously share files. This works either in send or in receive mode.
       OnionShare  sets  up  use  a  Tor  hidden  service  to  either make files on your computer
       temporarily accessible over the Internet,  or  allows  the  uploading  of  files  to  your
       computer  using  a  hidden  service.  OnionShare  generates an unguessable URL to down- or
       upload files that you can share with your peers.

       In case of sharing with many peers, please  enable  "Public  mode",  otherwise  OnionShare
       might interpret multiple accesses as an attack and shut down the hidden service.

       OnionShare can configured to run with it's built-in version of tor, a TorBrowser or system
       tor running in the background. By default, OnionShare uses the built-in version of Tor.

       In the case of OnionShare, the crypto key lives in /tmp/onionshare/tmpXXX/private_key. The
       .onion  URL address itself is a fingerprint of the key, which lets the Tor network look up
       the public key and start an encrypted session. So as long as you transmit  the  OnionShare
       URL  successfully,  the recipient who loads it in Tor Browser gets an end-to-end encrypted
       session with the server.

       OnionShare's default behaviour is to shut down the hidden service and  to  stop  once  the
       file  has  been  downloaded.  You  can  prevent this behaviour by invoking the --stay-open
       option. This can be useful if you want multiple people to access the same file.

OPTIONS

       --help display a short help message and exit

       --local-only
              don't run a public hidden service, just run on localhost

       --receive
              Receive shares instead of sending them

       --stay-open
              don't exit after file has been successfully downloaded

       --stealth
              Create stealth onion service (advanced)

       --shutdown-timeout N
              Shut down the onion service after N seconds

       --config CONFIGFILE
              Path to a custom JSON config file (optional)

       --debug
              enable more verbose output

AUTHOR

       Manual page by Ulrike Uhlig <ulrike at debian dot org>

                                          April 24, 2018                            onionshare(1)