Skip to content

OnionShare Release Notes

Lockdown Systems collective · A desktop app that uses the Tor network to share files privately, host websites, and chat.

CaskFiles and Storage 7.2K
Install command
brew install --cask onionshare
30-day installs
38
#1395 in App
1-year installs
320
Last 365 days
Latest version
2.7.2
Download size
184MB
dmg
Release cadence
Irregular
1 release in 30 days
  1. 2.7.2

    LatestPatch

    OpenNavo editorial

    OnionShare 2.7.2 was released on 2026-11-07. This update stops a CLI share after the first download when that option is on, and cleans non-ASCII usernames in Chat.

    OnionShare 2.7.2 was released on 2026-11-07. This update stops a CLI share after the first download when that option is on, and cleans non-ASCII usernames in Chat.

    • Security: In CLI mode, a share set to stop after the first download now stops. Desktop mode was not affected.
    • Security: Chat mode cleans non-ASCII usernames.
    • Bug fix: Fetching GeoIP from the Tor archive works again when building.
    • Bug fix: Timer tests work for reproducible builds.
    • Improvement: PySide6 enums are scoped.
    • i18n: A Hungarian translation was added.
    • Other: Dependencies were updated.
  2. 2.7.1

    Patch

    OpenNavo editorial

    Fixes freezes, crashes and resumable file sharing, and updates dependencies.

    • Prevent freezes, especially on Windows, caused by excessive Tor output filling subprocess pipes.
    • Avoid a KeyError when reporting an exception without a message, and call is_authenticated() as a method.
    • Stop compressing individual file shares so range requests can resume downloads.
    • Fix crashes after drag-and-drop alert dialogs on Flatpak and lock-file problems that prevent restarting.
    • Update dependencies.

    Official release notes

  3. 2.7

    OpenNavo editorial

    Download mode, Webtunnel bridges and safer file sharing

    Adds in-app downloads, Webtunnel bridges and Receive Mode upload limits.

    Changes
    Adds in-app downloads, Webtunnel bridges and Receive Mode upload limits.Blocks sharing a single symlink; improves dark mode and large-file progress.Uses UNIX sockets for the web server on macOS and Linux.Updates Tor to 0.4.9.14 and other bundled dependencies.
    • Adds in-app downloads, Webtunnel bridges and Receive Mode upload limits.
    • Blocks sharing a single symlink; improves dark mode and large-file progress.
    • Uses UNIX sockets for the web server on macOS and Linux.
    • Updates Tor to 0.4.9.14 and other bundled dependencies.

    Source: https://github.com/onionshare/onionshare/blob/v2.7/CHANGELOG.md

  4. 2.6.5

    Expand

    OpenNavo editorial Added to Homebrew

    This release updates Tor dependencies and other Python and web dependencies.

    Dependencies
    Updates Tor dependencies.Updates other Python and web dependencies.

    OnionShare 2.6.5 updates Tor dependencies, along with other Python and web dependencies. The release evidence does not specify individual dependencies or further changes.

    Source: https://github.com/onionshare/onionshare/releases/tag/v2.6.5

  5. 2.6.4

    Expand

    GitHub Release

    2.6.4

    • Security fix: Prevent symlink traversal
    • Security fix: Prevent upload of files when file upload mode is disabled. Prevent creation of empty folder on empty POST request payload
    • Dependencies: Updates tor dependencies and other python and web dependencies. Also updates flatpak runtime.
    • Bug fix: Show indeterminate progress and warn user during Tor traversal
  6. 2.6.3

    Expand

    GitHub Release

    2.6.3

    • Feature: It is now possible to view what URLs are visited in Share/Website mode using the CLI tool, with --log-filenames.
    • Feature: It is now possible to automatically start a saved persistent onion tab, once OnionShare itself starts and once Tor is connected.
    • Bug fix: It is now once again possible to request bridges and use meek as a Pluggable Transport.
    • Bug fix: Fixed a fatal error with Censorship Circumvention when no bridges are returned.
    • Bug fix: Fixed an issue with lack of gevent with SocketIO on systems that don't have it.
    • Bug fix: Fixed a thread-related race condition segfault with the CLI tool on shutdown.
    • Bug fix: Fixed an issue with the 'auto-stop timer' when the CLI tool is being used in 'Share mode' and someone has visited the share at least once. Desktop was unaffected, as were all other modes.
    • Locales: Gaeilge, Slovenčina and Tamil languages introduced, and various other translations in existing languages added or improved (thanks to the translators!)
    • Documentation: Added examples of using a systemd unit file for persistent onions, and various other clarifications.
    • Documentation: Documented all the config file parameters and what they mean, as well as that for persistent onion json files.
    • Packaging: Built the snap with a cleanup step in such a way that it should work on Ubuntu 24.04 and higher. Unfortunately, we have to drop support for armhf for now, as there are no PySide6 packages available on Pypi to install for that architecture. However, ARM64 is supported.
    • Packaging: Fixed ARM64 packaging for Flatpak.
    • Packaging: Many internal packaging improvements that make it easier for us to release snap and flatpak.
    • Miscellaneous: Many dependency updates to Python libraries, Tor, Snowflake
    • Miscellaneous: Various minor bug fixes/warning messages resolved, and minor changes to some wording for the 'Save this tab' option to make it clearer that this means 'persistent onion address'.
    • Miscellaneous: Nicer and more intuitive icons with better dark mode support.
  7. 2.6.2

    Expand

    OpenNavo editorial Added to Homebrew

    This release includes five security fixes covering history paths, Receive-mode message length, usernames, chat disconnection, and username-validation exceptions.

    Security
    Remove newline characters from History item paths.Limit Receive-mode text messages to 524288 characters.Restrict usernames to specified ASCII characters; remove controls.Force chat disconnection when a disconnect event occurs.Handle username-validation exceptions to prevent silent joining.

    OnionShare 2.6.2 makes five security-related changes. It removes newline characters from History item paths and caps text messages in Receive mode at 524288 characters. Username handling now permits only specified ASCII characters and removes control characters. The release also forcefully disconnects a user from chat on a disconnect event, and handles username-validation exceptions to prevent a user from joining silently.

    Source: OnionShare 2.6.2 release notes

  8. 2.6.1

    Expand

    OpenNavo editorial Added to Homebrew

    Updates build and packaging workflows, upgrades dependencies including Tor, meek, and snowflake, and fixes Tor-related behavior, a Windows packaging conflict, and other issues.

    Builds
    Automates builds with CI.The Windows release is 64-bit only.One universal2 macOS release covers Intel and Apple Silicon.
    Fixes
    Restores tab primary_action settings after Tor reconnects.Fixes Tor auto-connect with persistent tabs open.Fixes a Windows packaging conflict with Dangerzone.Fixes the “Use a bridge” checkbox state change.Raises an error from waitress if it is not shut down.

    OnionShare 2.6.1 changes release build and packaging workflows: builds are automated with CI, the Windows release is 64-bit only, and macOS has one universal2 release for Intel and Apple Silicon. Dependencies are upgraded, including Tor, meek, and snowflake.

    The release fixes several Tor-related behaviors. Tab primary_action mode settings are restored after OnionShare reconnects to Tor, and auto-connecting to Tor is fixed when persistent tabs are open. The “Use a bridge” checkbox state change is also fixed. On Windows, a packaging issue that caused a conflict with Dangerzone is corrected. The release also raises an error from waitress if it is not shut down.

    Source: https://github.com/onionshare/onionshare/releases/tag/v2.6.1

  9. 2.6

    Expand

    GitHub Release

    What's new:

    • Major feature: a new 'Quickstart' screen, which enables toggling on or off an animated automatic connection to Tor. This allows configuring network settings prior to automatic connection.
    • Major feature: Censorship circumvention. Use new features in the upstream Tor API to try to automatically obtain bridges depending on the user's location.
    • New feature: automatically fetch the built-in bridges from the upstream Tor API rather than hardcode them in each release of OnionShare.
    • New feature: keyboard shortcuts to access various modes and menus, and accessibility hints
    • Bug fix: Temporary Directory for serving the OnionShare web pages was broken on Windows
    • Packaging: Packaging is more automated, and Linux Snapcraft releases are available for amd64, arm64, and armhf
    • Miscellaneous: Many dependency updates and web page theming improvements
  10. 2.5

    Expand

    GitHub Release

    What's new:

    • Security fix: Sanitize the path parameter in History item widget to be plain text
    • Security fix: Use microseconds in Receive mode directory creation to avoid potential DoS
    • Security fix: Several hardening improvements for session and username management in Chat mode, to prevent impersonation and other issues
    • Major feature: Obtain bridges from Moat / BridgeDB (over a domain-fronted Meek client)
    • Major feature: Snowflake bridge support
    • New feature: Tor connection settings, as well as general settings, are now Tabs rather than dialogs
    • New feature: User can customize the Content-Security-Policy header in Website mode
    • New feature: Built-in bridges are automatically updated from Tor's API when the user has chosen to use them
    • Switch to using our stem fork called cepa, which is now published on PyPi so we can build it in releases
    • Various bug fixes
  11. 2.4.dev1

    Expand

    GitHub Release

    This is a pre-release for testing and for translators.

    Documentation for version 2.4.dev1 is here.

    Windows installer: OnionShare-2.4.dev1.msi macOS installer: OnionShare-2.4.dev1.dmg To install in Linux: snap install --devmode ~/Downloads/onionshare_2.4.dev1_amd64.snap

  12. 2.4

    Expand

    GitHub Release

    What's new:

    • Major feature: Private keys (v3 onion client authentication) replaces passwords and HTTP basic auth
    • Updated Tor to 0.4.6.7 on all platforms
    • Various bug fixes
  13. 2.3.3

    Expand

    GitHub Release

    What's new:

    • New feature: Setting for light or dark theme
    • Updated Tor to 0.4.6.7 for Linux, 0.4.5.10 for Windows and macOS
    • Various bug fixes
  14. 2.3.2.dev1

    Expand

    GitHub Release

    This is a pre-release for testing and for translators.

    Documentation for version 2.3.2.dev1 is here. Specifically check these new/updated sections:

    Windows installer: OnionShare-2.3.2.dev1.msi macOS installer: OnionShare-2.3.2.dev1.dmg To install in Linux: snap install --devmode ~/Downloads/onionshare_2.3.2.dev1_amd64.snap

  15. 2.3.2

    Expand

    GitHub Release

    What's new:

    • New feature: Custom titles can be set for OnionShare's various modes
    • New feature: Receive mode supports notification webhooks
    • New feature: Receive mode supports submitting messages as well as files
    • New feature: New ASCII art banner and prettier verbose output
    • New feature: Partial support for range requests (pausing and resuming in HTTP)
    • Updated Tor to 0.4.5.7
    • Updated built-in obfs4 bridges
    • Various bug fixes
  16. 2.3.1

    Expand

    GitHub Release

    What's new:

    • Bugfix: Fix chat mode
    • Bugfix: Fix --persistent in onionshare-cli
    • Bugfix: Fix checking for updates in Windows and macOS
  17. 2.3.dev2

    Expand

    GitHub Release

    This is a development release. It's not quite ready and still has bugs.

    • To install Linux Flatpak: flatpak install ./OnionShare-2.3.dev2.flatpak
    • To install Linux Snapcraft: snap install --devmode ./onionshare_2.3.dev2_amd64.snap
    • Windows: OnionShare-2.3.dev2.msi
    • macOS: OnionShare-2.3.dev2.dmg
  18. 2.3

    Expand

    GitHub Release

    What's new:

    • Major new feature: Multiple tabs, including better support for persistent services, faster Tor connections
    • New feature: Chat anonymously mode
    • New feature: All new design
    • New feature: Ability to display QR codes of OnionShare addresses
    • New feature: Web apps have responsive design and look better on mobile
    • New feature: Flatpak and Snapcraft packaging for Linux
    • Several bug fixes
  19. 2.2.dev1

    Expand

    GitHub Release

    For macOS download OnionShare-2.2.dev1.pkg. For Windows download onionshare-2.2.dev1-setup.exe. For Linux, install from repositories or build from source.

    What's new:

    • New feature: Website mode, which allows publishing a static HTML website as an onion service
    • Allow individual files to be viewed or downloaded in Share mode, including the ability to browse into subdirectories and use breadcrumbs to navigate back
    • Show a counter when individual files or pages are viewed
    • Better History items including colors and status codes to differentiate between successful and failed requests
    • Swap out the random /slug suffix for HTTP basic authentication (when in non-public mode)
    • Hide the Tor connection settings if the ONIONSHARE_HIDE_TOR_SETTINGS environment variable is set (Tails compatibility)
    • Remove the NoScript XSS warning in Receive Mode now that the NoScript/Tor Browser bug is fixed. The ajax upload method still exists when javascript is enabled.
    • Better support for DragonFly BSD
    • Updated various dependencies, including Flask, Werkzeug, urllib3, requests, and PyQt5
    • Updated Tor to 0.4.1.5
    • Other minor bug fixes
  20. 2.2

    Expand

    GitHub Release

    For macOS download OnionShare-2.2.pkg. For Windows download onionshare-2.2-setup.exe. For Linux, install from repositories or build from source.

    What's new:

    • New feature: Website mode, which allows publishing a static HTML website as an onion service
    • Allow individual files to be viewed or downloaded in Share mode, including the ability to browse into subdirectories and use breadcrumbs to navigate back
    • Show a counter when individual files or pages are viewed
    • Better History items including colors and status codes to differentiate between successful and failed requests
    • Swap out the random /slug suffix for HTTP basic authentication (when in non-public mode)
    • Hide the Tor connection settings if the ONIONSHARE_HIDE_TOR_SETTINGS environment variable is set (Tails compatibility)
    • Remove the NoScript XSS warning in Receive Mode now that the NoScript/Tor Browser bug is fixed. The ajax upload method still exists when javascript is enabled.
    • Better support for DragonFly BSD
    • Updated various dependencies, including Flask, Werkzeug, urllib3, requests, and PyQt5
    • Updated Tor to 0.4.1.5
    • Other minor bug fixes
    • New translations:
      • Arabic (العربية)
      • Dutch (Nederlands)
      • Persian (فارسی)
      • Romanian (Română)
      • Serbian latin (Srpska (latinica))
    • Removed translations with fewer than 90% of strings translated:
      • Finnish (Suomi)
  21. 2.1

    Expand

    GitHub Release

    For macOS download OnionShare-2.1.pkg. For Windows download onionshare-2.1-setup.exe. For Linux, install from repositories or build from source.

    What's new:

    • New feature: Auto-start timer, which allows scheduling when the server starts
    • Renamed CLI argument --debug to --verbose
    • Make Tor connection timeout configurable as a CLI argument
    • Updated various dependencies, including to fix third-party security issues in urllib3, jinja2, and jQuery
    • Update Tor to 0.3.5.8
    • New translations:
      • Traditional Chinese (正體中文 (繁體)),
      • Simplified Chinese (中文 (简体))
      • Finnish (Suomi)
      • German (Deutsch)
      • Icelandic (Íslenska)
      • Irish (Gaeilge)
      • Norwegian Bokmål (Norsk Bokmål)
      • Polish (Polski)
      • Portuguese Portugal (Português (Portugal))
      • Telugu (తెలుగు)
      • Turkish (Türkçe)
      • Ukrainian (Українська)
    • Removed translations because less than 90% of the strings were translated:
      • Bengali (বাংলা)
      • Persian (فارسی)