[WIP] Ensure Etherpad is supported in popular software

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

---

This section details on the original issue you should resolve

<issue_title>Go through popular software and ensure Etherpad is supported</issue_title>
<issue_description>Software like home assistant could easily run etherpad in a docker container and it would provide value for the HA admin.

1. Identify software that would be suitable.
2. Ensure it's one click is well supported/working/documented.

This would be a step towards helping others host Etherpad locally without having to modify code/run commands.</issue_description>

Comments on the Issue (you are @copilot in this section)

@JohnMcLear Survey of self-hosted app platforms / catalogs for Etherpad. Current upstream release at time of survey: **v2.6.1** (2026-01-26).

Platform	Listed?	Maintainer	Last update	Notes / gap
Home Assistant Add-ons / Apps	No	—	—	Not in hassio-addons/repository nor in any discoverable community HA repo. Highest-leverage gap: issue author explicitly called this out.
YunoHost (basic)	Yes	YunoHost-Apps/etherpad_ynh	commits 2026-04-10	Active. Uses Rustydb (no plugins by default).
YunoHost (MyPads)	Yes	YunoHost-Apps/etherpad_mypads_ynh	commits 2026-02-03	Active. Preconfigured with plugin bundle.
Umbrel App Store	Yes	community submitter dennysubke; manifest in getumbrel/umbrel-apps	v2.6.1, merged 2026-01-28	One-click, tracks upstream within days. Admin at :9002/admin/, postgres backend. Healthy.
Cloudron	Yes	Cloudron team	package v2.6.1, 2026-01-27	One-click, LDAP-integrated, auto-updates, docs at https://docs.cloudron.io/packages/etherpad/. Healthy.
TrueCharts (TrueNAS SCALE)	Yes	trueforge-org/truecharts	Chart.yaml shows appVersion: 1.8.14	Stale app version (upstream is 2.6.1). Chart deps are auto-bumped by Renovate but the image tag has not moved. Also note TrueNAS SCALE 24.10+ no longer ships third-party catalogs by default.
Unraid Community Applications	Yes (community template)	SmartPhoneLover	template thread opened 2023-02-12, ongoing forum support	Wraps official etherpad/etherpad image, so version tracks whatever tag user picks. Not an official listing. Could not verify last template commit.
CasaOS App Store (official)	No	—	—	Checked official store (160 apps) and third-party stores big-bear-casaos, CasaOS-Coolstore, CasaOS-LinuxServer-AppStore — none have etherpad. Realistic PR target.
Sandstorm App Market	Yes	kentonv (Sandstorm author) — fork at kentonv/etherpad-lite@sandstorm	Market listing: v1.5.6, 2015-08-01. Blog post Aug 2025 reports running 1.8.18-1 locally	Very stale market package (pinned to 1.x from 2015). Sandstorm itself is a low-activity platform; listing exists but should be refreshed or documented as legacy.
Nextcloud app store — Ownpad	Yes (integration, not server)	otetard/ownpad	v0.13.2 released 2025-10-07, repo pushed 2026-02-20	Active. Embeds an existing Etherpad in Nextcloud. Requires separate Etherpad host.
Docker Hub etherpad/etherpad	Yes (official)	Etherpad Foundation	continuous, 10M+ pulls, tag 2.6.1	Canonical distribution. Docs at https://docs.etherpad.org/docker.html. Healthy.
Linuxserver.io	No	—	—	A 2020 request thread exists but was not picked up. Etherpad foundation already ships an official image, so a linuxserver.io duplicate is low-value.
Bitnami	Not found in current catalog	—	—	No current Etherpad chart/image visible. Not a priority given upstream image.
Snap Store	No	—	—	Only abandoned experiments: asac/etherpad-lite-snap (2016), Fohlen/etherpad-lite-snapcraft (2016). No published snap.
Flathub	No (n/a)	—	—	Flathub is desktop-app focused; Etherpad is a server, so this is correctly absent.
Proxmox VE Helper-Scripts (community)	No	—	—	479 scripts in community-scripts/ProxmoxVE/ct/; CryptPad has a script, Etherpad does not. Realistic PR target — the project actively accepts new scripts.
awesome-selfhosted	Yes	community	kept current	Listed under collaboration with Sandstorm demo link. Fine as-is.

Recommendations

High-leverage gaps to fill (add new listings):

1. Home Assistant Add-ons — issue author called this out by name, and it reaches a very large self-hoster audience. Build an HA add-on (Dockerfile + config.yaml) and publish under either hassio-addons community org or a dedicated ether/hassio-etherpad repo. The official Docker image makes this a thin wrapper.
2. Proxmox VE Helper-Scripts — huge Proxmox homelab audience, already has CryptPad; contributing an etherpad.sh to community-scripts/ProxmoxVE is a straightforward PR.
3. CasaOS App Store — absent from both the official store and the major third-party stores; a manifest PR to IceWhaleTech/CasaOS-AppStore or bigbeartechworld/big-bear-casaos would land Etherpad in front of the CasaOS/ZimaOS users.

Stale listings worth refreshing:

• TrueCharts chart still pinned to appVersion: 1.8.14 — worth a PR bumping the image tag to 2.6.x (or at least opening an issue). The chart itself is still receiving Renovate bumps for its common dependency.
• Sandstorm App Market listing has not been updated since 2015 (1.5.6). Given Sandstorm is low-activity, the pragmatic move may be to simply document the listing as legacy rather than invest in a modern repackage — but worth confirming with kentonv.

Healthy as-is (no action needed): YunoHost (both packages), Umbrel, Cloudron, official Docker Hub image, Nextcloud/Ownpad integration, awesome-selfhosted.

Skip: Linuxserver.io (official image already exists), Flathub (desktop catalog, n/a), Bitnami (low demand), Snap Store (no active interest since 2016).

Could not verify: exact last-commit date of the Unraid SmartPhoneLover etherpad template; whether Bitnami has ever shipped an Etherpad chart.

@JohnMcLear Things like snap or .deb need to be CI built on release... @Gared There is also https://github.com/bigbluebutton/bigbluebutton/blob/v3.0.x-develop/bbb-etherpad.placeholder.sh which is installing version 1.9.4 of etherpad. Seems to me that a lot of etherpad instances are running because of this bigbluebutton application @JohnMcLear > First you've had AI generate a list, but not spend even a second to check if its correct (for example, TrueCharts is, and has always been, a Helm Chartcatalog that has had nothing to do with TrueNAS SCALE for years). > > Then you had the same AI start spamming projects with your "fixes", without checking the project contribution guidelines. > > You should be removed as a maintainer for behaviour like this towards other projects.

Two specific points worth addressing head-on:

1. TrueCharts ≠ TrueNAS SCALE. The original survey miscategorised TrueCharts as a TrueNAS-only catalog; it's a general Helm chart repo. Apologies to the TrueCharts maintainers for that framing.
2. Contribution guidelines. At least two of the downstream PRs I opened did not start by reading the target project's PR template / CONTRIBUTING. Rectifying in each one.

Current state of the downstream work this issue prompted:

Target	PR	Status
TrueCharts Helm chart (1.8.14 → 2.6.1)	trueforge-org/truecharts#47234	❌ Closed by maintainer. Cleaned-up diff (unintended drift removed, image switched to ghcr.io/ether/etherpad) is on the fork branch if anyone wants to revive it.
CasaOS App Store	IceWhaleTech/CasaOS-AppStore#919	✅ CI green, awaiting maintainer review
Proxmox VE Helper-Scripts	community-scripts/ProxmoxVED#1723	⚠️ Changes requested — legitimate code review (use fetch_and_deploy_gh_release, selfh.st icon, Debian 13). To revise.
Home Assistant add-on scaffold (upstream)	#7560	Open
Snap packaging (upstream)	#7558	Open
Debian .deb build (upstream)	#7559	✅ Merged
GHCR publishing (upstream)	#7569	✅ Merged. 2.6.1/2.6/2/latest mirrored to ghcr.io/ether/etherpad (multi-arch, identical digest to Docker Hub: sha256:69a697fe6bf75aecf8748d734bcca5f0e596a6eeec8342ab030d0da8a6f224d5).
CI: auto-open downstream-bump tracking issue on each release	#7561	Open

Going forward, for each downstream: follow the target's template, respond to review on its merits, and drop generated trailers. Flag any specific PR that still looks wrong and I'll fix it there.