Dev/OnionShare
Notes[edit]
- Qubes-Whonix ™ users should consider creating a separate, cloned
whonix-ws-16-onionshare
Template 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]

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!