From 1d7e2c0402a686093fadcf16a895f005b202b1ea Mon Sep 17 00:00:00 2001 From: cyrneko Date: Wed, 26 Aug 2026 00:32:04 +0200 Subject: [PATCH 1/2] chore: update installation guide to mention new mobile/desktop apps also clarify the "Self hosting" part --- content/installation/_index.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/content/installation/_index.md b/content/installation/_index.md index 35b572f..8afe29a 100644 --- a/content/installation/_index.md +++ b/content/installation/_index.md @@ -8,9 +8,12 @@ page_template = "page.html" # Getting started The web app is available at [app.sable.moe](https://app.sable.moe/) and gets updated on frequently, as soon as a feature is deemed stable. -Native desktop and mobile builds are still being worked on in [#88](https://github.com/SableClient/Sable/issues/88). For now, use the web app directly, or [install it as a Progressive Web App (PWA) on your phone.](https://www.installpwa.com/from/app.sable.moe) +The latest changes on the `main` branch are available at + +Native desktop and mobile apps are available [on GitHub](https://github.com/SableClient/Sable/releases) + +# Self-hosting on the web -# Self-hosting You have a few options for self hosting, you can: 1. Run the prebuilt docker container. 2. Deploy on a site like GitLab Pages. Jae has a [guide here](https://docs.j4.lc/Tutorials/Deploying-Sable-on-GitLab-Pages). From 9fed6d4c00762bbd9407c33302bfd3c43ba8a7bf Mon Sep 17 00:00:00 2001 From: cyrneko Date: Wed, 26 Aug 2026 00:46:12 +0200 Subject: [PATCH 2/2] First draft for the "Matrix for beginners" guide --- content/matrix-guide/_index.md | 93 +++++++++++++++++++++++++++++++++- 1 file changed, 92 insertions(+), 1 deletion(-) diff --git a/content/matrix-guide/_index.md b/content/matrix-guide/_index.md index 320fa3b..5b8baec 100644 --- a/content/matrix-guide/_index.md +++ b/content/matrix-guide/_index.md @@ -5,4 +5,95 @@ template = "index.html" page_template = "page.html" +++ -hi + + +> [!TIP] +> This page assumes you know a *little* bit about chat apps in +> general. Which you likely do if you ended up here. Welcome! + +Matrix is, at it's core, another chat-app. Similar to Discord, Signal, +WhatsApp or whatever else you might be using. + +It has some important differences though, that makes it resistant to +many of the reasons you probably seek refuge here; But let's not get +ahead of ourselves and actually talk about what Matrix *is*. + +Matrix is a decentralized approach to messaging. Instead of having +one, single provider, we have multiple! And thanks to the underlying +tech, we can all talk to one another regardless of the provider you +choose. + +It's also an *open network*, where the entire text and technical +information on how it works is publicly accessible, and a +collaborative effort. Anyone can create a chat-app using it and is +encouraged to share their efforts, so that others can also implement +eachother's features. + +Sable is but one player in the wider ecosystem, there is [many +more](https://matrix.org/ecosystem/clients) out there, including +[server-software](https://matrix.org/ecosystem/servers) for those of +us that wan't to become their own provider (or provide just for +themselves!). + +But enough with the sales pitch, let's get to actually hopping on +Matrix. + +## Getting Started: For regular users + +To get started, you can [Download Sable](/installation) or use it on +the web at + +You can leave options at their default and just hit `Continue with +Matrix.org` and create an account. Though, it should be stated that +further down in this guide, we list some reasons as to why you might +wanna consider spending a *little* extra time picking out another +provider. + +Regardless, you can continue and register, and when you're done you'll +be at an empty screen that looks and feels a bit like Discord! + +From here you can: +- Create a room from the sidebar > Home > Create room +- Create a space (more on that later) from the sidebar > [+] > Create + new space +- Join an existing room from the sidebar > Home > Join with Address +- Swap over to Direct Messages with the icon below Home in the sidebar + +### Useful words and terminology + +- Spaces: A collection of rooms! This can either be for private use, + or for public communities. They have separate permissions from the + rooms inside +- Direct Message: Anything that appears in the Direct Messages tab, + usually one-on-one discussions +- Alias or Address: The human-readable address to a room or space, + usually something like this: `#example:matrix.org` +- Invite: manually inviting a specific user to a room or DM using the + UI; Links to rooms/spaces are *not* called invites by most people +- MXID: Short for "Matrix ID", it's your unique username+provider + combo, like `@bob:matrix.org` + +### Why you should consider signing up somewhere other than Matrix.org + +Matrix is decentralized, as previously discussed, and this gives it +one major strength: There's no one company or anything else that can +dictate the rules, whether or not your account gets banned, or whether +you can keep talking to your friends. + +Though, by principle, this becomes less and less relevant if everyone +is using the same provider. That freedom is lost, because it means a +majority of the users can *still* be screwed over by that large +provider. + +To avoid this, all you need to do is sign up on a different server, +one that isn't the default Matrix.org. Not only will you not have to +worry about this hypothetical, but chances are the provider will be +faster because there will be much less people using it at the same +time :) + +There is a list of public servers, together with security information +and data about how long they've been operating at + + +> [!WARNING] +> Do note: This page is *not* maintained by the Matrix.org Foundation.