Shrooms - Revision history

Eleutherious: Plainer prose: fewer quotes, project claims attributed, glosses folded in

2026-11-04T23:27:47Z

Plainer prose: fewer quotes, project claims attributed, glosses folded in

Eleutherious: Second check: fixes to facts, dates (UTC), glosses and attribution

2026-11-04T21:01:10Z

Second check: fixes to facts, dates (UTC), glosses and attribution

← Older revision		Revision as of 21:01, 4 November 2026
Line 10:		Line 10:
	\| verified_against = README and commit of 4 November 2026		\| verified_against = README and commit of 4 November 2026
	}}		}}
	'''Shrooms''' is a mesh VPN that uses [[Logos Messaging]] (Logos Delivery) for discovery and signalling and WireGuard for the traffic. It has a Linux daemon, an Android app and a [[Basecamp]] view, and is published by the GitHub user vpavlin.		'''Shrooms''' is a mesh VPN that uses [[Logos Messaging]] (Logos Delivery) for discovery and signalling and WireGuard, a standard VPN protocol, for the traffic. It has a Linux daemon, an Android app and a [[Basecamp]] view, and is published by the GitHub user vpavlin.

	== What it does ==		== What it does ==
	* ~~Lets~~ nodes find each other through Logos Delivery pub/sub, with no coordination server and no account. Delivery is used only for cold start, roaming and repair, and tunnels keep working when the fleet is unreachable.		* It lets nodes find each other through Logos Delivery pub/sub (publish-and-subscribe messaging), with no coordination server and no account. Delivery is used only for cold start, roaming and repair, and tunnels keep working when the fleet is unreachable.
	* ~~Carries~~ traffic over userspace WireGuard, directly between peers where NAT allows. When two peers cannot reach each other, it relays through a node the user already runs.		* It carries traffic over userspace WireGuard, directly between peers where NAT allows. NAT is the way home routers and mobile networks hide many devices behind one address. When two peers cannot reach each other, it relays through a node the user already runs.
	* ~~Derives~~ each node's overlay address from its device key, so no addresses are handed out and none conflict.		* It derives each node's overlay address (its address inside the mesh) from its device key, so no addresses are handed out and none conflict.
	* ~~Answers~~ names such as <code>laptop.mesh</code> and <code>immich.home-server.mesh</code> with its own resolver, and can publish local services and LAN devices by name.		* It answers names such as <code>laptop.mesh</code> and <code>immich.home-server.mesh</code> with its own resolver, and can publish local services and LAN devices by name.
	* ~~Admits~~ devices with one-time invite tokens and admin-signed credentials that expire after 30 days by default and can be revoked.		* It admits devices with one-time invite tokens and admin-signed credentials that expire after 30 days by default and can be revoked.
	* ~~Runs~~ several meshes from one daemon, each with its own key, identity, interface and port.		* It runs several meshes from one daemon, each with its own key, identity, interface and port.
	* ~~Shows~~ the mesh in a Basecamp view with a graph, peers, services, logs and settings.		* It shows the mesh in a Basecamp view with a graph, peers, services, logs and settings.
	* ~~Offers~~ Shrooms Agents, a separate app and Basecamp module for reaching Claude Code or pi coding-agent sessions on the user's own machines from a phone or from Basecamp.		* It offers Shrooms Agents, a separate app and Basecamp module for reaching Claude Code or pi coding-agent sessions on the user's own machines from a phone or from Basecamp.
	The project was renamed from logos-vpn.		The project was renamed from logos-vpn.

	Stage: Prototype. The README says "It is a prototype, used daily by its author and nobody else." ~~It opens with~~ "This is an experiment, and there are no guarantees of any kind." ~~and~~ says it "has never been audited by anybody independent". The README does not say whether it is an official Logos project.		Stage: Prototype. The README says "It is a prototype, used daily by its author and nobody else." Its opening warning reads "This is an experiment, and there are no guarantees of any kind." It also says the project "has never been audited by anybody independent". The README does not say whether it is an official Logos project.

	== Use it ==		== Use it ==
Line 31:		Line 31:
	# For Android, add <code>https://apps.vpavlin.xyz/fdroid/repo</code> to F-Droid and install Shrooms, and Shrooms Agents if wanted.		# For Android, add <code>https://apps.vpavlin.xyz/fdroid/repo</code> to F-Droid and install Shrooms, and Shrooms Agents if wanted.
	# For Basecamp, add <code>https://apps.vpavlin.xyz/basecamp/logos-repo.json</code> and install Shrooms. Its <code>shrooms_core</code> companion comes with it.		# For Basecamp, add <code>https://apps.vpavlin.xyz/basecamp/logos-repo.json</code> and install Shrooms. Its <code>shrooms_core</code> companion comes with it.
	A Linux node needs glibc 2.38 or later (Ubuntu 24.04 works, Debian 12 does not), <code>/dev/net/tun</code>~~, and~~ one inbound UDP port, 51820 by default. A five-minute [https://shrooms.vpavlin.xyz/start.html quick start] is on the project website. The README does not name a Basecamp version.		A Linux node run outside the container needs glibc (the standard C library) 2.38 or later. Ubuntu 24.04 works and Debian 12 does not. Every node needs <code>/dev/net/tun</code> (a virtual network device). At least one end of every pair of nodes needs an inbound UDP port, 51820 by default. A five-minute [https://shrooms.vpavlin.xyz/start.html quick start] is on the project website. The README does not name a Basecamp version.

	== Build it ==		== Build it ==
Line 46:		Line 46:
	* [[Tools]]		* [[Tools]]
	* [[Logos Messaging]]		* [[Logos Messaging]]
	* [[Reelcut]]		* [[Reelcut]]: also by vpavlin

	== Sources ==		== Sources ==
Line 52:		Line 52:
	* [https://github.com/vpavlin/shrooms/blob/master/basecamp/metadata.json basecamp/metadata.json], [https://github.com/vpavlin/shrooms/blob/master/basecamp/core/metadata.json basecamp/core/metadata.json] and [https://github.com/vpavlin/shrooms/blob/master/basecamp-agents/metadata.json basecamp-agents/metadata.json], GitHub		* [https://github.com/vpavlin/shrooms/blob/master/basecamp/metadata.json basecamp/metadata.json], [https://github.com/vpavlin/shrooms/blob/master/basecamp/core/metadata.json basecamp/core/metadata.json] and [https://github.com/vpavlin/shrooms/blob/master/basecamp-agents/metadata.json basecamp-agents/metadata.json], GitHub
	* [https://github.com/vpavlin/shrooms/tags shrooms tags], GitHub		* [https://github.com/vpavlin/shrooms/tags shrooms tags], GitHub
			* [https://github.com/vpavlin/shrooms/blob/master/scripts/install.sh scripts/install.sh], GitHub

	{{Page status\|Stub}}		{{Page status\|Stub}}

Eleutherious: New tool page, source-checked against the project README

2026-11-04T19:10:26Z

New tool page, source-checked against the project README

New page

{{Infobox tool
| name = Shrooms
| what = The mycelial mesh VPN: discovery over Logos Delivery, traffic over WireGuard, no coordination server
| stage = Prototype
| licence = Apache-2.0 or MIT
| code = https://github.com/vpavlin/shrooms
| use = https://github.com/vpavlin/shrooms#get-started
| build = https://github.com/vpavlin/shrooms#1-build
| verified_on = 4 November 2026
| verified_against = README and commit of 4 November 2026
}}
'''Shrooms''' is a mesh VPN that uses [[Logos Messaging]] (Logos Delivery) for discovery and signalling and WireGuard for the traffic. It has a Linux daemon, an Android app and a [[Basecamp]] view, and is published by the GitHub user vpavlin.

== What it does ==
* Lets nodes find each other through Logos Delivery pub/sub, with no coordination server and no account. Delivery is used only for cold start, roaming and repair, and tunnels keep working when the fleet is unreachable.
* Carries traffic over userspace WireGuard, directly between peers where NAT allows. When two peers cannot reach each other, it relays through a node the user already runs.
* Derives each node's overlay address from its device key, so no addresses are handed out and none conflict.
* Answers names such as <code>laptop.mesh</code> and <code>immich.home-server.mesh</code> with its own resolver, and can publish local services and LAN devices by name.
* Admits devices with one-time invite tokens and admin-signed credentials that expire after 30 days by default and can be revoked.
* Runs several meshes from one daemon, each with its own key, identity, interface and port.
* Shows the mesh in a Basecamp view with a graph, peers, services, logs and settings.
* Offers Shrooms Agents, a separate app and Basecamp module for reaching Claude Code or pi coding-agent sessions on the user's own machines from a phone or from Basecamp.
The project was renamed from logos-vpn.

Stage: Prototype. The README says "It is a prototype, used daily by its author and nobody else." It opens with "This is an experiment, and there are no guarantees of any kind." and says it "has never been audited by anybody independent". The README does not say whether it is an official Logos project.

== Use it ==
# On the first Linux machine, download <code>scripts/install.sh</code> from the repository and run <code>sudo bash install.sh init --mesh home --name laptop</code>. The README asks users to read the script before running it as root.
# Run <code>sudo shrooms invite</code>. It prints a token and a QR code, good for one device and fifteen minutes, and waits.
# On the new device, run <code>sudo shrooms join TOKEN</code> with the printed token, or scan the QR code with the Android app.
# For Android, add <code>https://apps.vpavlin.xyz/fdroid/repo</code> to F-Droid and install Shrooms, and Shrooms Agents if wanted.
# For Basecamp, add <code>https://apps.vpavlin.xyz/basecamp/logos-repo.json</code> and install Shrooms. Its <code>shrooms_core</code> companion comes with it.
A Linux node needs glibc 2.38 or later (Ubuntu 24.04 works, Debian 12 does not), <code>/dev/net/tun</code>, and one inbound UDP port, 51820 by default. A five-minute [https://shrooms.vpavlin.xyz/start.html quick start] is on the project website. The README does not name a Basecamp version.

== Build it ==
* The build machine needs Go 1.26 or later with cgo and a C toolchain, and <code>liblogosdelivery</code>. <code>make deps-release</code> downloads a prebuilt copy of the library.
* <code>make shrooms</code> builds the binary and <code>sudo make install</code> installs it with a systemd unit.
* <code>make dist</code> and <code>make dist-arm64</code> build portable packages. <code>scripts/deploy.sh</code> builds a container image and ships it to a host over ssh.
* <code>make apk</code> builds the Android app (details in ANDROID.md) and <code>make basecamp-lgx</code> builds the Basecamp package.

== Releases ==
The latest version tag is v0.9.0, dated 21 September 2026. Two later tags, deps-v2 (20 October 2026) and deps-v3 (23 October 2026), are dependency releases. The README links deps-v1 as a repackaged copy of liblogosdelivery. In <code>metadata.json</code>, the Basecamp view <code>shrooms</code> is version 0.14.0, <code>shrooms_core</code> is 0.29.0 and <code>shrooms_agents</code> is 0.59.0.

== See also ==
* [[Basecamp]]
* [[Tools]]
* [[Logos Messaging]]
* [[Reelcut]]

== Sources ==
* [https://github.com/vpavlin/shrooms shrooms README], GitHub, last commit 4 November 2026
* [https://github.com/vpavlin/shrooms/blob/master/basecamp/metadata.json basecamp/metadata.json], [https://github.com/vpavlin/shrooms/blob/master/basecamp/core/metadata.json basecamp/core/metadata.json] and [https://github.com/vpavlin/shrooms/blob/master/basecamp-agents/metadata.json basecamp-agents/metadata.json], GitHub
* [https://github.com/vpavlin/shrooms/tags shrooms tags], GitHub

{{Page status|Stub}}

← Older revision		Revision as of 23:27, 4 November 2026
Line 10:		Line 10:
	\| verified_against = README and commit of 4 November 2026		\| verified_against = README and commit of 4 November 2026
	}}		}}
	'''Shrooms''' is a mesh VPN that uses [[Logos Messaging]] (Logos Delivery) for discovery and signalling and WireGuard, a standard VPN protocol, for the traffic. It has a Linux daemon, an Android app and a [[Basecamp]] view, and ~~is published by the GitHub user vpavlin~~.		'''Shrooms''' is a mesh VPN by the GitHub user vpavlin that uses [[Logos Messaging]] (Logos Delivery) for discovery and signalling and WireGuard, a standard VPN protocol, for the traffic. It has a Linux daemon, an Android app and a [[Basecamp]] view, and was renamed from logos-vpn.

	== What it does ==		== What it does ==
	* ~~It lets nodes~~ find each other through Logos Delivery pub/sub (publish-and-subscribe messaging), with no coordination server and no account. Delivery is used only for cold start, roaming and repair, and tunnels keep working when the fleet is unreachable.		* Nodes find each other through Logos Delivery pub/sub (publish-and-subscribe messaging), with no coordination server and no account. Delivery is used only for cold start, roaming and repair, and tunnels keep working when the fleet is unreachable.
	* ~~It carries traffic~~ over userspace WireGuard, directly between peers where NAT allows. NAT is the way home routers and mobile networks hide many devices behind one address. When two peers cannot reach each other, it relays through a node the user already runs.		* Traffic runs over userspace WireGuard, directly between peers where NAT allows. NAT is the way home routers and mobile networks hide many devices behind one address. When two peers cannot reach each other, Shrooms relays through a node the user already runs.
	* ~~It derives each~~ node's overlay address (its address inside the mesh) from its device key, so no addresses are handed out and none conflict.		* Each node's overlay address, its address inside the mesh, is derived from its device key, so no addresses are handed out and none conflict.
	* It answers names such as <code>laptop.mesh</code> and <code>immich.home-server.mesh</code> ~~with its own resolver~~, and can publish local services and LAN devices by name.		* Its own resolver answers names such as <code>laptop.mesh</code> and <code>immich.home-server.mesh</code>, and it can publish local services and LAN devices by name.
	* ~~It admits devices~~ with one-time invite tokens and admin-signed credentials ~~that~~ expire after 30 days by default and can be revoked.		* Devices are admitted with one-time invite tokens and admin-signed credentials, which expire after 30 days by default and can be revoked.
	* It runs several meshes ~~from one daemon~~, each with its own key, identity, interface and port.		* One daemon runs several meshes, each with its own key, identity, interface and port.
	* It shows the mesh ~~in a Basecamp view~~ with a graph, peers, services, logs and settings.		* A Basecamp view shows the mesh with a graph, peers, services, logs and settings.
	* ~~It offers~~ Shrooms Agents, a separate app and Basecamp module ~~for reaching~~ Claude Code or pi coding-agent sessions on the user's own machines from a phone or from Basecamp.		* Shrooms Agents, a separate app and Basecamp module, reaches Claude Code or pi coding-agent sessions on the user's own machines from a phone or from Basecamp.
	~~The project was renamed from logos-vpn~~.

	Stage: Prototype. The README says "It is a prototype, used daily by its author and nobody else." Its opening warning reads "This is an experiment, and there are no guarantees of any kind." ~~It also~~ says the project "has never been audited by anybody independent". The README does not say whether it is an official Logos project.		Stage: Prototype. The README says "It is a prototype, used daily by its author and nobody else." Its opening warning reads "This is an experiment, and there are no guarantees of any kind", and it says the project has never been audited by anybody independent. The README does not say whether it is an official Logos project.

	== Use it ==		== Use it ==
	# On the first Linux machine, download <code>scripts/install.sh</code> from the repository and ~~run~~ <code>sudo bash install.sh init --mesh home --name laptop</code>~~. The README asks users to read the script before running it as root~~.		# On the first Linux machine, download <code>scripts/install.sh</code> from the repository and read it before running it as root with <code>sudo bash install.sh init --mesh home --name laptop</code>.
	# Run <code>sudo shrooms invite</code>. It prints a token and a QR code, good for one device and fifteen minutes, and waits.		# Run <code>sudo shrooms invite</code>. It prints a token and a QR code, good for one device and fifteen minutes, and waits.
	# On the new device, run <code>sudo shrooms join TOKEN</code> with the printed token, or scan the QR code with the Android app.		# On the new device, run <code>sudo shrooms join TOKEN</code> with the printed token, or scan the QR code with the Android app.
	# For Android, add <code>https://apps.vpavlin.xyz/fdroid/repo</code> to F-Droid and install Shrooms, and Shrooms Agents if wanted.		# For Android, add <code>https://apps.vpavlin.xyz/fdroid/repo</code> to F-Droid and install Shrooms, and Shrooms Agents if wanted.
	# For Basecamp, add <code>https://apps.vpavlin.xyz/basecamp/logos-repo.json</code> and install Shrooms. Its <code>shrooms_core</code> companion comes with it.		# For Basecamp, add <code>https://apps.vpavlin.xyz/basecamp/logos-repo.json</code> and install Shrooms. Its <code>shrooms_core</code> companion comes with it.
	A Linux node run outside the container needs glibc (the standard C library~~) 2.38 or later~~. Ubuntu 24.04 works and Debian 12 does not. Every node needs <code>/dev/net/tun</code> (a virtual network device~~). At~~ least one end of every pair of nodes needs an inbound UDP port, 51820 by default. A five-minute [https://shrooms.vpavlin.xyz/start.html quick start] is on the project website. The README does not name a Basecamp version.		A Linux node run outside the container needs version 2.38 or later of glibc, the standard C library. Ubuntu 24.04 works and Debian 12 does not. Every node needs <code>/dev/net/tun</code>, a virtual network device, and at least one end of every pair of nodes needs an inbound UDP port, 51820 by default. A five-minute [https://shrooms.vpavlin.xyz/start.html quick start] is on the project website. The README does not name a Basecamp version.

	== Build it ==		== Build it ==