Securely and anonymously share files, host websites, and chat with friends using the Tor network
Go to file
2014-05-20 20:57:39 +00:00
.gitignore ignoring vim swp files 2014-05-20 19:43:42 +00:00
LICENSE added GPLv3 license 2014-05-20 20:56:45 +00:00
onionshare.py you can download the file now, and it almost displays filename, size, and hash 2014-05-20 20:57:39 +00:00
README.md updated readme 2014-05-20 19:43:32 +00:00

OnionShare

A program to securely share a file of any size with someone, designed to be run in Tails. It works by starting a web server, making it accessible as a Tor hidden service, and making it require a password to access and download the file. It doesn't require setting up a server on the internet somewhere or using a third party filesharing service. It all just runs inside Tails and uses the Tor network.

Quick Start

Boot to Tails, setting an administrator password. Clone this repository. Install the dependencies:

sudo apt-get install python-flask

Then run onionshare.py, and pass it a filename. It will look something like this:

amnesia@amnesia:~/Persistent/code/onionshare$ sudo ./onionshare.py ~/Persistent/file_to_send.gpg
[sudo] password for amnesia:
Modifying torrc to configure hidden service on port 41710
Reloading tor daemon configuration...                                                                                                             [  DONE  ]
Punching a hole in the firewall
Waiting 10 seconds for hidden service to get configured...

Give this information to the person youre sending the file to:
URL: http://b6vgwkuo77qieguy.onion/
Username: 5eebeba8b70cfdfc
Password: f5a7fa91c294479a

Press Ctrl-C to stop server

 * Running on http://127.0.0.1:41710/
127.0.0.1 - - [20/May/2014 19:41:19] "GET / HTTP/1.1" 401 -
127.0.0.1 - - [20/May/2014 19:41:28] "GET / HTTP/1.1" 200 -
127.0.0.1 - - [20/May/2014 19:41:31] "GET /favicon.ico HTTP/1.1" 404 -
127.0.0.1 - - [20/May/2014 19:41:31] "GET /favicon.ico HTTP/1.1" 404 -

Securely send the URL, username, and password to the person you are sending the file to (like by using Jabber and OTR). When they load the website, they will be connecting directly to your computer. They'll need the username and password to authenticate. You can watch all the web requests that are getting made.

Once you confirm that they have downloaded the file you're sending (ask them), press Ctrl-C to shut down the server and clean up your Tails setup.

Restoring original torrc
Reloading tor daemon configuration...                                                                                                             [  DONE  ]
Closing hole in firewall