Skip to content

This document is a WORK IN PROGRESS.
This is just a quick personal cheat sheet: treat its contents with caution!


OnionShare is an open source tool that lets you securely and anonymously share files, host websites, and chat with friends using the Tor network.


Table of contents


# pacman -S onionshare
# apt install onionshare


Change the default data directory (data_dir) location:

$ mkdir -p ~/.local/share/onionshare
$ vi ~/.config/onionshare/onionshare.json
    > ...
  ~ > "data_dir": "/home/user/.local/share/onionshare",
    > ...

If you want to set a password:

$ vi ~/.config/onionshare/onionshare.json
    > ...
  ~ > "password": "your-secret-password",
    > ...


To share a file, just run:

$ onionshare /path/to/file/or/directory/to/share

Then, share the *.onion link to the downloader. This link shall be open with the tor browser. If a username and a password are asked (even if none has been set), the default username is onionshare without password.

If this cheat sheet has been useful to you, then please consider leaving a star here.