Dev/OnionShare
Donate
Developers only! Risk of Tor over Tor!
Notes[edit]
- Qubes-Whonix ™ users should consider creating a separate, cloned
whonix-ws-16-onionshareTemplate before installing OnionShare/flatpak. - OnionShare from the Debian stable repository is suitable for most users. Flatpak can be utilized for later OnionShare versions; v2.4 is packaged at the time of writing. [1]
[edit]
Install onionshare via flatpak.
1. Select your platform.
A : Non-Qubes-Whonix ™
2. Add flathub repository. [2]
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
3. Install the flatpak onionshare package.
flatpak install flathub onionshare
4. Done.
The procedure of installing onionshare is complete.
5. Upgrades notice.
Note: this procedure will not keep the software up-to-date. How to update installation installed by flatpak is also documented on the Operating System Software and Updates wiki page.
B : Qubes-Whonix ™ Template
whonix-ws-16)2. Add flathub repository. [3]
http_proxy=http://127.0.0.1:8082 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
3. Install the flatpak onionshare package.
http_proxy=http://127.0.0.1:8082 flatpak install flathub onionshare
4. Done.
The procedure of installing onionshare is complete.
5. Upgrades notice.
Note: this procedure will not keep the software up-to-date. How to update installation installed by flatpak is also documented on the Operating System Software and Updates wiki page.
C : Qubes-Whonix ™ App Qube
anon-whonix)2. Add flathub repository. [4]
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
3. Install the flatpak onionshare package.
flatpak --user install flathub onionshare
4. Done.
The procedure of installing onionshare is complete.
5. Upgrades notice.
Note: this procedure will not keep the software up-to-date. How to update installation installed by flatpak is also documented on the Operating System Software and Updates wiki page.
Issue[edit]
Flatpak installed OnionShare does not listen on all network interfaces but 127.0.0.1 only. It is therefore unreachable from Whonix-Gateway ™. This is because file /usr/share/anon-ws-base-files/workstation does not exist inside the Flatpak folder.
related:
https://github.com/onionshare/onionshare/blob/develop/cli/onionshare_cli/web/web.py#L360_L364
Does the following help?
sudo mkdir /var/lib/flatpak/app/org.onionshare.OnionShare/current/active/files/share/anon-ws-base-files
sudo touch /var/lib/flatpak/app/org.onionshare.OnionShare/current/active/files/share/anon-ws-base-files/workstation
flatpak breaks application's Whonix detection #4640
Debugging[edit]
To see what's happening "under the hood". When using Debian package installed OnionShare version only. This does not work for Flatpak installed OnionShare version.
uwtwrapper_verbose=1 onionshare
View listener.
netstat -tulpen
Should show Local Address 0.0.0.0, meaning listening on all interfaces which is required in case of Whonix ™ so onionshare running inside Whonix-Workstation ™ can be reached from Whonix-Gateway. (As opposed to onionshare running on a host without Whonix ™ where it should listen on localhost 127.0.0.1 onl.y
Proto Recv-Q Send-Q Local Address Foreign Address State User Inode PID/Program name [...] tcp 0 0 0.0.0.0:17605 0.0.0.0:* LISTEN 1000 30959 4009/python3
uwt and bindp is no longer required since Whonix ™ 16 (Debian bullseye based).
/usr/bin/onionshare.anondist-orig a
Footnotes[edit]
At
Whonix we believe in freedom and trust. That's why we fully support Open Source and Freedom Software.
Whonix ™ is supported by Evolution Host DDoS Protected VPS.
ENCRYPTED SUPPORT LP,
2023
We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 10 year success story and maybe DONATE!