https://github.com/nyxnor/onioncomms
OnionComms is a repository of script to run an onion server and guides to configure client side applications to connect to any onion service that uses the same protocol, therefore, onion communications.
https://github.com/nyxnor/onioncomms
file-sharing hidden-service instant-messaging omemo onion-service open-source otr privacy proxy remote-administration rss security self-hosted tor tor-network voip xmpp xmpp-server
Last synced: 2 days ago
JSON representation
OnionComms is a repository of script to run an onion server and guides to configure client side applications to connect to any onion service that uses the same protocol, therefore, onion communications.
- Host: GitHub
- URL: https://github.com/nyxnor/onioncomms
- Owner: nyxnor
- License: gpl-3.0
- Created: 2021-08-24T02:20:11.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-02-08T18:44:35.000Z (over 3 years ago)
- Last Synced: 2025-04-09T02:12:33.487Z (2 months ago)
- Topics: file-sharing, hidden-service, instant-messaging, omemo, onion-service, open-source, otr, privacy, proxy, remote-administration, rss, security, self-hosted, tor, tor-network, voip, xmpp, xmpp-server
- Language: Lua
- Homepage:
- Size: 153 KB
- Stars: 14
- Watchers: 5
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OnionComms
OnionComms is a repository of script to run an onion server and guides to configure client side applications to connect to any onion service that uses the same protocol, therefore, onion communications.
---
Table of contents
---
- [OnionComms](#onioncomms)
- [Server](#server)
- [Client](#client)
- [Applications](#applications)
- [Tor](#tor)
- [Remote-Administration](#remote-administration)
- [File-Sharing](#file-sharing)
- [RSS](#rss)
- [VOIP](#voip)
- [XMPP](#xmpp)
- [IRC](#irc)
- [Misc](#misc)
---
## Server
Read the README inside the folder of the program you want to use, the scripts are non-interactive unless a password needs to be set. They were designed for Debian and derived systems.
## Client
[TORIFICATION.MD](TORIFICATION.md) is a must read on how to do properly torifications of applications. In short:
- application proxy settings may fail and leak DNS requests and IP address (per application)
- enforce proxy with a wrapper may also fail if not using the libc and leak DNS requests and IP address (torsocks, orbot)
- transparent proxy has huge security problems, it does not protect agains protocol leaks but the IP address will never be revealed (Tails)
- isolating proxy is the best solution as no leaks occur but it requires two host (virtual or physical) (Whonix)
The client guides are intended for plain Debian users, therefore application proxy settings and enforcing a proxy with a wrapper is the only solution, which isn't great but it is what is available.
Transparent proxy is hard to configure system wide and isolating proxy requires advanced configuration of creating a network between two hosts, these methods already route everything through Tor, so you don't need to configure the client to have onion routing, as all the traffic already does. What may change are simple configurations such as enforcing TCP mode or "hardening" by removing some "bad features" that leaks protocol information.
## Applications
### [Tor](tor)
Application|Client|Server
-|-|-
[tor](tor#tor)|yes|yes
[torsocks](tor#torsocks)|yes|no
[Tor Browser](tor#tor-browser)|yes|no
[Orbot](tor#orbot)|yes|no
### [Remote-Administration](remote-administration)
Application|Client|Server
-|-|-
[OpenSSH client](remote-administration#openssh-client)|yes|no
[OpenSSH server](remote-administration#openssh-server)|no|yes
[Remmina](remote-administration#remmina)|yes|yes
TODO: Remmina guide is incomplete.
### [File-Sharing](file-sharing)
Application|Client|Server
-|-|-
[Magic-wormhole](file-sharing#magic-wormhole)|yes|no
[OnionShare](file-sharing#onionshare)|no|yes
### [RSS](rss)
Application|Client|Server
-|-|-
[Newsboat](rss#newsboat)|yes|no
[QuiteRSS](rss#quiterss)|yes|no
### [VOIP](voip)
Application|Client|Server
-|-|-
[Mumble](voip#mumble)|yes|no|
[Mumble-server](voip#mumble-server)|no|yes|
### [XMPP](xmpp)
Application|Client|Server
-|-|-
[Prosody](xmpp/prosody)|no|yes|
[Ejabberd](xmpp/ejabberd)|no|yes|
[Pidgin](xmpp#clients)|yes|no|
[Dino IM](xmpp#clients)|yes|no|
TODO: Every XMPP client guide is incomplete.
### [IRC](irc)
Application|Client|Server
-|-|-
[Hexchat](irc#hexchat)|yes|no|
[Irssi](irc#irssi)|yes|no|
### [Misc](misc)
Application|Client|Server
-|-|-
[apt](misc#apt)|yes|no|
[wget](misc#wget)|yes|no|
[cURL](misc#curl)|yes|no|
[git](misc#git)|yes|no|
[gpg](misc#gpg)|yes|no|
[Ricochet-refresh](misc#ricochet-refresh)|yes|yes|
[TEG](misc#teg)|yes|no|
TODO: TEG guide is incomplete.