-
Notifications
You must be signed in to change notification settings - Fork 637
Configuring OnionShare
You can access Settings by clicking on the 'cog' icon in the bottom right corner of the OnionShare application.
Some of the settings are described below.
If this setting is checked (enabled), then the Onion Hidden Service will stop automatically once the user has started downloading your share for the first time.
If you need to share your file with several users or allow the user to download it more than once in one sitting, you should uncheck (disable) this setting.
This setting is enabled by default.
If this setting is checked, the sender will receive a desktop notification (e.g pop-up or systray bubble) when a user commences or completes a download.
This can be convenient if you don't wish to watch the OnionShare application's status bar itself and move on to other tasks, but wish to be notified when the user starts the download process.
If you don't wish to receive desktop notifications, you should uncheck this setting.
This setting is enabled by default.
If you want to use stealth onion services, you should enable this setting. For more information on Stealth Onion Services, please visit this page.
This setting is disabled by default.
If this setting is checked, Windows and macOS users will receive notifications when a new version of OnionShare is available. You may also click the 'Check For Updates' button to force a check.
This setting is not shown for Linux users. Instead, Linux users should rely on their package management system (e.g apt) to install updates.
Several options exist for obtaining a Tor connection:
- Use Tor that is bundled with OnionShare
- Attempt automatic configuration with Tor Browser
- Connect using (Tor) control port
- Connect using (Tor) socket file
'Use Tor that is bundled with OnionShare' is usually the easiest and most convenient setting, because it requires no further action from the user to set up.
For more information on the other options available, please visit this page.
You cannot click or modify the settings if you have an active share running.
Stop the share and then you will be able to modify the settings.
Once you have saved the settings, you can start a new share.
The settings are stored in a JSON file on your computer. When you click 'Save' in the settings dialog, the settings are re-written to the JSON file and OnionShare reloads its settings from that file.
If you have changed the Tor connection method, then clicking Save will also reconnect to Tor.
The location of the JSON file varies depending on your Operating System:
In ~/.config/onionshare/onionshare.json
In ~/Library/Application Support/Onionshare/onionshare.json
In %APPDATA%\Onionshare\onionshare.json
%APPDATA%
is usually located in C:\Users\<your user name>\AppData
NOTE: You should never have to manually edit the json file directly. This information is provided only for advanced or curious users.