From e5a64074bdea1715dd47823abf1b18dbc08aa144 Mon Sep 17 00:00:00 2001 From: Aine Date: Tue, 7 Apr 2026 20:29:58 +0100 Subject: [PATCH 1/4] Availability page --- README.md | 45 +++++---------------- docker/docker-compose-dev.yml | 2 + docs/README.md | 1 + docs/availability.md | 75 +++++++++++++++++++++++++++++++++++ 4 files changed, 88 insertions(+), 35 deletions(-) create mode 100644 docs/availability.md diff --git a/README.md b/README.md index cc957429..d56a740a 100644 --- a/README.md +++ b/README.md @@ -149,44 +149,19 @@ management: | | Where | Details | |---|---|---| -| 🏠 | **[etke.cc](https://etke.cc/?utm_source=github&utm_medium=readme&utm_campaign=ketesa)** | Core component of the managed hosting platform | -| 🌐 | **[admin.etke.cc](https://admin.etke.cc)** | Hosted instance, always on the latest version | -| πŸ“¦ | **[GitHub Releases](https://github.com/etkecc/ketesa/releases)** | Prebuilt tarballs for root-path and `/admin` subpath deployment | -| 🐳 | **[Docker Hub](https://hub.docker.com/r/etkecc/ketesa) / [GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa)** | Official Docker images | -| πŸ€– | **[matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/docs/configuring-playbook-ketesa.md)** | Ansible playbook component | -| ❄️ | **[Nix package](https://search.nixos.org/packages?show=synapse-admin-etkecc)** | Maintained by [@Defelo](https://github.com/Defelo) | -| 🐧 | **[Arch Linux AUR](https://aur.archlinux.org/packages/synapse-admin-etke-git)** | Maintained by [@drygdryg](https://github.com/drygdryg) | -| 🌊 | **[IPFS](https://ipfs.io)** | Maintained by [FΠ΅nΠΈΠΊs (@fenuks:sibnsk.net)](https://matrix.to/#/@fenuks:sibnsk.net) β€” see [details below](#ipfs) | +| 🏠 | **[etke.cc](https://etke.cc/?utm_source=github&utm_medium=readme&utm_campaign=ketesa)** | Managed hosting with Ketesa built in | +| 🌐 | **[admin.etke.cc](https://admin.etke.cc)** | Hosted instance, always on the latest development version | +| πŸ“¦ | **[GitHub Releases](https://github.com/etkecc/ketesa/releases)** | Official prebuilt tarballs for root-path and `/admin` deployments | +| 🐳 | **[GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa) / [Docker Hub](https://hub.docker.com/r/etkecc/ketesa/tags)** | Official container images | +| πŸ”§ | **[Source](https://github.com/etkecc/ketesa)** | Build from source or track `main` directly | -### Prebuilt distributions +Official static builds: -We offer two prebuilt distributions for different deployment paths: +- **`ketesa.tar.gz`** for root path deployment, such as `https://admin.example.com` +- **`ketesa-subpath-admin.tar.gz`** for `/admin` deployments, such as `https://example.com/admin` -- **`ketesa.tar.gz`** β€” for root path deployment (e.g., `https://admin.example.com`) -- **`ketesa-subpath-admin.tar.gz`** β€” for `/admin` subpath deployment (e.g., `https://example.com/admin`) - -Find the latest **released** versions on [GitHub Releases](https://github.com/etkecc/ketesa/releases). -Find the latest **development (nightly)** builds in [GitHub Actions](https://github.com/etkecc/ketesa/actions/workflows/workflow.yml) -β€” click the latest successful run and download `dist-root` or `dist-subpath-admin` from the Artifacts section. - -### πŸŒ™ Nightly builds - -Stay on the bleeding edge: - -- 🌐 **[admin.etke.cc](https://admin.etke.cc)** β€” always running the latest development version -- 🐳 **Docker** β€” use the `latest` or `latest-subpath-admin` image tags on [GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa) or [Docker Hub](https://hub.docker.com/r/etkecc/ketesa/tags) -- πŸ“¦ **Artifacts** β€” `dist-root` / `dist-subpath-admin` from the latest [GitHub Actions run](https://github.com/etkecc/ketesa/actions/workflows/workflow.yml) -- πŸ”§ **Source** β€” clone the `main` branch and build it yourself - -### IPFS - -> Maintained by [FΠ΅nΠΈΠΊs (@fenuks:sibnsk.net)](https://matrix.to/#/@fenuks:sibnsk.net) - -**Latest version:** `/ipns/synapse-admin.sibnsk.net` -(dnslink key `/ipns/k51qzi5uqu5dj91scsxoqu0ebmy7uqajrt9ohl98vs7fl7l429h0chgozk58i2`) - -**Archive:** `/ipns/synapse-admin-archive.sibnsk.net` -(dnslink key `/ipns/k51qzi5uqu5dhxwc36sld1hn6jn935k71ww8rdyqomrnqcqucixy7re08qeu7z`) +For nightly builds, distro packages, Ansible integrations, and IPFS, +see the [full availability guide](./docs/availability.md). --- diff --git a/docker/docker-compose-dev.yml b/docker/docker-compose-dev.yml index 111e45eb..deb43bf9 100644 --- a/docker/docker-compose-dev.yml +++ b/docker/docker-compose-dev.yml @@ -69,6 +69,8 @@ services: postgres: image: postgres:17-alpine + ports: + - "5432:5432" volumes: - ../docs/testdata/postgres.data:/var/lib/postgresql/data - ../docs/testdata/postgres.initdb:/docker-entrypoint-initdb.d:ro diff --git a/docs/README.md b/docs/README.md index d18202ca..d331c0af 100644 --- a/docs/README.md +++ b/docs/README.md @@ -81,4 +81,5 @@ Specific topics: ## πŸš€ Deployment +* [Availability](./availability.md) β€” where to get Ketesa: official builds, distro packages, integrations, mirrors, and legacy compatibility links * [Serving Ketesa behind a reverse proxy](./reverse-proxy.md) diff --git a/docs/availability.md b/docs/availability.md new file mode 100644 index 00000000..07a03b5e --- /dev/null +++ b/docs/availability.md @@ -0,0 +1,75 @@ +# πŸ“¦ Availability + +This page is the canonical "where to get Ketesa" reference. +It collects official release channels, deployment integrations, community-maintained packaging, +and alternative distribution options. + +> ⚠️ Community-maintained and third-party entries may lag behind official releases. +> When in doubt, prefer the official release tarballs, containers, or the hosted instance. + +## βœ… Official channels + +| Channel | Type | Maintainer | Best for | Notes | +|---|---|---|---|---| +| [etke.cc](https://etke.cc/?utm_source=github&utm_medium=docs&utm_campaign=ketesa) | Managed hosting | Official | Fully managed deployments | Ketesa is a core component of the etke.cc Matrix platform | +| [admin.etke.cc](https://admin.etke.cc) | Hosted instance | Official | Zero-install access | Always on the latest development version | +| [GitHub Releases](https://github.com/etkecc/ketesa/releases) | Static builds | Official | Self-hosting behind any web server | Includes `ketesa.tar.gz` and `ketesa-subpath-admin.tar.gz` | +| [GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa) | Container image | Official | Docker and OCI-based deployments | Main image registry | +| [Docker Hub](https://hub.docker.com/r/etkecc/ketesa/tags) | Container image | Official | Docker-first users | Mirrors the official container images | +| [matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/docs/configuring-playbook-ketesa.md) | Ansible integration | Official | Operators using the MDAD playbook | Maintained by the etke.cc team | +| [etkecc/ansible](https://github.com/etkecc/ansible) | Ansible integration | Official | etke.cc-flavoured self-hosted automation | Also writes Ketesa config into `/.well-known/matrix/client` automatically | +| [Source repository](https://github.com/etkecc/ketesa) | Source code | Official | Building from source or contributing | Use when you need custom builds or development checkouts | + +### Prebuilt distributions + +Ketesa publishes two static distributions: + +- `ketesa.tar.gz` for root path deployments such as `https://admin.example.com` +- `ketesa-subpath-admin.tar.gz` for `/admin` subpath deployments such as `https://example.com/admin` + +For custom prefixes other than `/admin`, build from source with `yarn build --base=/your-prefix` +or pass the `BASE_PATH` Docker build argument. + +## 🀝 Community-packaged options + +| Channel | Type | Maintainer | Best for | Notes | +|---|---|---|---|---| +| [YunoHost app](https://apps.yunohost.org/app/synapse-admin) | App catalog package | [@Josue-T](https://github.com/Josue-T) | YunoHost-based deployments | Listed in the YunoHost app catalog under the legacy `synapse-admin` name | +| [IPFS](#ipfs) | Mirror / alternative delivery | [FΠ΅nΠΈΠΊs (@fenuks:sibnsk.net)](https://matrix.to/#/@fenuks:sibnsk.net) | Content-addressed distribution | Current and archive addresses are listed below | + +## 🐧 Distro packages + +| Channel | Type | Maintainer | Best for | Notes | +|---|---|---|---|---| +| [Nix package search](https://search.nixos.org/packages?show=synapse-admin-etkecc) | Package index | [@Defelo](https://github.com/Defelo) | Nix and NixOS users | Package still uses the legacy `synapse-admin-etkecc` name | +| [MyNixOS package page](https://mynixos.com/nixpkgs/package/synapse-admin-etkecc) | Package index | [@Defelo](https://github.com/Defelo) | Users who want a friendlier Nix package view | Alternate index for the same Nix package | +| [Arch Linux AUR](https://aur.archlinux.org/packages/synapse-admin-etke-git) | AUR package | [@drygdryg](https://github.com/drygdryg) | Arch users who prefer AUR packaging | Legacy package naming; maintained outside this repository | + +## πŸŒ™ Nightly and development builds + +If you want the latest unreleased changes: + +- Use [admin.etke.cc](https://admin.etke.cc) for the hosted development version +- Pull `latest` or `latest-subpath-admin` from [GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa) or [Docker Hub](https://hub.docker.com/r/etkecc/ketesa/tags) +- Download `dist-root` or `dist-subpath-admin` from the latest successful [GitHub Actions run](https://github.com/etkecc/ketesa/actions/workflows/workflow.yml) +- Build the `main` branch from [source](https://github.com/etkecc/ketesa) + +## IPFS + +> Maintained by [FΠ΅nΠΈΠΊs (@fenuks:sibnsk.net)](https://matrix.to/#/@fenuks:sibnsk.net) + +**Latest version:** `/ipns/synapse-admin.sibnsk.net` +(`dnslink` key `/ipns/k51qzi5uqu5dj91scsxoqu0ebmy7uqajrt9ohl98vs7fl7l429h0chgozk58i2`) + +**Archive:** `/ipns/synapse-admin-archive.sibnsk.net` +(`dnslink` key `/ipns/k51qzi5uqu5dhxwc36sld1hn6jn935k71ww8rdyqomrnqcqucixy7re08qeu7z`) + +## πŸ“ Want your package listed? + +Open a pull request if you maintain a Ketesa package, mirror, or deployment integration. +Please include: + +- the package or project link +- whether it is official, community-maintained, or a third-party mirror +- who maintains it +- any important caveats, especially if it still uses legacy `synapse-admin` naming From e836276990544644c5625ffee54aff011eaa4b2f Mon Sep 17 00:00:00 2001 From: Aine Date: Tue, 7 Apr 2026 20:35:31 +0100 Subject: [PATCH 2/4] improve wording, fix typos --- docs/availability.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/availability.md b/docs/availability.md index 07a03b5e..fca3bc99 100644 --- a/docs/availability.md +++ b/docs/availability.md @@ -11,13 +11,13 @@ and alternative distribution options. | Channel | Type | Maintainer | Best for | Notes | |---|---|---|---|---| -| [etke.cc](https://etke.cc/?utm_source=github&utm_medium=docs&utm_campaign=ketesa) | Managed hosting | Official | Fully managed deployments | Ketesa is a core component of the etke.cc Matrix platform | +| [etke.cc](https://etke.cc/?utm_source=github&utm_medium=docs&utm_campaign=ketesa) | Managed hosting | Official | Fully managed deployments | Ketesa is [a core component](https://etke.cc/help/faq#what-are-the-base-matrix-components-installed-on-the-server) installed by default | | [admin.etke.cc](https://admin.etke.cc) | Hosted instance | Official | Zero-install access | Always on the latest development version | | [GitHub Releases](https://github.com/etkecc/ketesa/releases) | Static builds | Official | Self-hosting behind any web server | Includes `ketesa.tar.gz` and `ketesa-subpath-admin.tar.gz` | | [GHCR](https://github.com/etkecc/ketesa/pkgs/container/ketesa) | Container image | Official | Docker and OCI-based deployments | Main image registry | | [Docker Hub](https://hub.docker.com/r/etkecc/ketesa/tags) | Container image | Official | Docker-first users | Mirrors the official container images | | [matrix-docker-ansible-deploy](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/master/docs/configuring-playbook-ketesa.md) | Ansible integration | Official | Operators using the MDAD playbook | Maintained by the etke.cc team | -| [etkecc/ansible](https://github.com/etkecc/ansible) | Ansible integration | Official | etke.cc-flavoured self-hosted automation | Also writes Ketesa config into `/.well-known/matrix/client` automatically | +| [etkecc/ansible](https://github.com/etkecc/ansible) | Ansible integration | Official | etke.cc-flavoured self-hosted automation | Maintained by the etke.cc team | | [Source repository](https://github.com/etkecc/ketesa) | Source code | Official | Building from source or contributing | Use when you need custom builds or development checkouts | ### Prebuilt distributions @@ -27,7 +27,7 @@ Ketesa publishes two static distributions: - `ketesa.tar.gz` for root path deployments such as `https://admin.example.com` - `ketesa-subpath-admin.tar.gz` for `/admin` subpath deployments such as `https://example.com/admin` -For custom prefixes other than `/admin`, build from source with `yarn build --base=/your-prefix` +For custom prefixes other than `/admin`, build from source with `yarn build --base=/your-prefix/` or pass the `BASE_PATH` Docker build argument. ## 🀝 Community-packaged options From 38039489781d580882b499f1ca74931b3eaff8e4 Mon Sep 17 00:00:00 2001 From: Aine Date: Wed, 8 Apr 2026 07:41:43 +0100 Subject: [PATCH 3/4] update ipfs links --- docs/availability.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/availability.md b/docs/availability.md index fca3bc99..60d40096 100644 --- a/docs/availability.md +++ b/docs/availability.md @@ -58,10 +58,10 @@ If you want the latest unreleased changes: > Maintained by [FΠ΅nΠΈΠΊs (@fenuks:sibnsk.net)](https://matrix.to/#/@fenuks:sibnsk.net) -**Latest version:** `/ipns/synapse-admin.sibnsk.net` +**Latest version:** `/ipns/ketesa.sibnsk.net` (`dnslink` key `/ipns/k51qzi5uqu5dj91scsxoqu0ebmy7uqajrt9ohl98vs7fl7l429h0chgozk58i2`) -**Archive:** `/ipns/synapse-admin-archive.sibnsk.net` +**Archive:** `/ipns/ketesa-archive.sibnsk.net` (`dnslink` key `/ipns/k51qzi5uqu5dhxwc36sld1hn6jn935k71ww8rdyqomrnqcqucixy7re08qeu7z`) ## πŸ“ Want your package listed? From de418cb40ee21d86ffbeffd1a226932534519edf Mon Sep 17 00:00:00 2001 From: Aine <97398200+aine-etke@users.noreply.github.com> Date: Fri, 10 Apr 2026 11:40:35 +0100 Subject: [PATCH 4/4] Update docs/availability.md Co-authored-by: Felix Bargfeldt <41747605+Defelo@users.noreply.github.com> --- docs/availability.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/availability.md b/docs/availability.md index 60d40096..b6e8983b 100644 --- a/docs/availability.md +++ b/docs/availability.md @@ -41,8 +41,7 @@ or pass the `BASE_PATH` Docker build argument. | Channel | Type | Maintainer | Best for | Notes | |---|---|---|---|---| -| [Nix package search](https://search.nixos.org/packages?show=synapse-admin-etkecc) | Package index | [@Defelo](https://github.com/Defelo) | Nix and NixOS users | Package still uses the legacy `synapse-admin-etkecc` name | -| [MyNixOS package page](https://mynixos.com/nixpkgs/package/synapse-admin-etkecc) | Package index | [@Defelo](https://github.com/Defelo) | Users who want a friendlier Nix package view | Alternate index for the same Nix package | +| [Nixpkgs](https://search.nixos.org/packages?channel=unstable&show=ketesa) | Package index | [@Defelo](https://github.com/Defelo) | Nix and NixOS users | | | [Arch Linux AUR](https://aur.archlinux.org/packages/synapse-admin-etke-git) | AUR package | [@drygdryg](https://github.com/drygdryg) | Arch users who prefer AUR packaging | Legacy package naming; maintained outside this repository | ## πŸŒ™ Nightly and development builds