pub.solar wiki - User contributions [en]

How-to: Change the statutes

2026-02-05T10:08:38Z

172.17.0.1: Add How-To category

You can find the current Version of the statutes in text Form in text Form [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md here]. The only version of the statutes that are legally binding are in German.

There's two ways to change the statutes:

# If the Finanzamt or Court demands it (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#10-salvatorische-klausel § 10 Salvatorische Klausel])
# Via the general assembly (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#7-mitgliederversammlung § 7 Mitgliederversammlung] and [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#8-erg%C3%A4nzende-dokumente § 8 Ergänzende Dokumente])

If you want to change the statutes of pub.solar e.V. you'll need to follow the following steps:

# Create a new version of the text
# Propose changes to the text to the next general assembly
# Win enough votes from the assembly
# The Vorstand goes to the notary

== 1. Create a new version of the text ==
You can edit the text in the browser or locally via git. After you've made the changes, you'll have to propose them to be accepted by opening a merge request (or "pull request").

[https://git.pub.solar/pub-solar/legal In the git repository], click on "Fork" on the top right of your screen, then confirm "Fork repository". This will create a copy of the pub.solar e.V. legal files in your own account.

You can then find the file '''satzung.md''', and open it. Click on the edit icon to open the browser-based editor.

Make your changes to the document.

To save, scroll down to the "Commit changes" section.

Give your change a title that the describes the change in short. In the description, explain why you want this change.

Select "Create a new branch for this commit and start a pull request".

Click "Commit changes".

You're going to be shown your changes when compared to the original. Review whether they're correct, and then in dropdown for "merge into:", select `pub-solar:main`.

Click "New pull request", and then "Create pull request".

Congratulations, you've successfully opened a pull request!

It's good to show a lot of people your proposal at this point to get some feedback.

== 2. Propose changes to the next general assembly ==
Contact the Vorstand and tell them you want to change the statutes at the next general assembly. They will have to put the item on the agenda in the invite.

== 3. Win enough votes at the assembly ==
For changes except in § 2, the normal voting rules for the general assembly apply. (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#7-mitgliederversammlung § 7 Mitgliederversammlung])

By German law, for changes to [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#2-zweck-des-vereins § 2 Zweck des Vereins] every member of the association will be needed to give an okay. So you will need not just a consensus at the assembly, but also to track down every member that was not at the assembly and get their signed thumbs-up.

== 4. The Vorstand goes to the notary ==
The new vorstand will have to hand over the following:

# The text of the invitation to the general assembly
# The text of the protocol of the assembly
# If needed, the signed okays of all people that were not available at the assembly.
# The new text of the statutes

After some time, the notary will confirm that the changes have taken effect.

[[Category:How-To]]

How-to: Change the statutes

2026-01-16T18:55:25Z

172.17.0.1: /* 3. Win enough votes at the assembly */

How-to: Change the statutes

2026-01-16T18:53:53Z

172.17.0.1: Init howto

You can find the current Version of the statutes in text Form in text Form [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md here]. The only version of the statutes that are legally binding are in German.

There's two ways to change the statutes:

# If the Finanzamt or Court demands it (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#10-salvatorische-klausel § 10 Salvatorische Klausel])
# Via the general assembly (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#7-mitgliederversammlung § 7 Mitgliederversammlung] and [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#8-erg%C3%A4nzende-dokumente § 8 Ergänzende Dokumente])

If you want to change the statutes of pub.solar e.V. you'll need to follow the following steps:

# Create a new version of the text
# Propose changes to the text to the next general assembly
# Win enough votes from the assembly
# The Vorstand goes to the notary

== 1. Create a new version of the text ==
You can edit the text in the browser or locally via git. After you've made the changes, you'll have to propose them to be accepted by opening a merge request (or "pull request").

[https://git.pub.solar/pub-solar/legal In the git repository], click on "Fork" on the top right of your screen, then confirm "Fork repository". This will create a copy of the pub.solar e.V. legal files in your own account.

You can then find the file '''satzung.md''', and open it. Click on the edit icon to open the browser-based editor.

Make your changes to the document.

To save, scroll down to the "Commit changes" section.

Give your change a title that the describes the change in short. In the description, explain why you want this change.

Select "Create a new branch for this commit and start a pull request".

Click "Commit changes".

You're going to be shown your changes when compared to the original. Review whether they're correct, and then in dropdown for "merge into:", select `pub-solar:main`.

Click "New pull request", and then "Create pull request".

Congratulations, you've successfully opened a pull request!

It's good to show a lot of people your proposal at this point to get some feedback.

== 2. Propose changes to the next general assembly ==
Contact the Vorstand and tell them you want to change the statutes at the next general assembly. They will have to put the item on the agenda in the invite.

== 3. Win enough votes at the assembly ==
By German law, for changes to [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#2-zweck-des-vereins § 2 Zweck des Vereins] every member of the association will be needed to give an okay. So you will need not just a consensus at the assembly, but also to track down every member that was not at the assembly and get their signed thumbs-up.

For changes that are not in § 2, the normal voting rules for the general assembly apply. (See [https://git.pub.solar/pub-solar/legal/src/branch/main/satzung.md#7-mitgliederversammlung § 7 Mitgliederversammlung])

== 4. The Vorstand goes to the notary ==
The new vorstand will have to hand over the following:

# The text of the invitation to the general assembly
# The text of the protocol of the assembly
# If needed, the signed okays of all people that were not available at the assembly.
# The new text of the statutes

After some time, the notary will confirm that the changes have taken effect.

Matrix

2025-09-17T15:04:51Z

172.17.0.1: /* Homeserver address for clients */

[[File:Matrix icon.svg|alt=[matrix] logo|40x40px]]

Matrix is an open-standard, encrypted, and federated chat protocol. Clients exist for multiple platforms, including iOS, Android, Windows, Mac, and Linux. The standard client is called Element, and can be downloaded at https://element.io/download. A web interface hosted by us can be found at [https://chat.pub.solar/ chat.pub.solar].

== Overview ==

This page will focus on setting up Matrix. It is divided into several sections:
; [[Matrix#Setting up|Setting up]]: Signing into your Matrix client
; [[Matrix#Bridging|Bridging]]: Setting up bridges to third-party / proprietary platforms.
; [[Matrix#Tips and Tricks|Tips and Tricks]]: How to enable some niceties.
; [[Matrix#Clients|Clients]]: Using a third-party app to connect to Matrix.

=== Learn More ===

More information on Matrix can be found on:
* [https://en.wikipedia.org/wiki/Matrix_(protocol) Matrix – Wikipedia]
* [https://joinmatrix.org/ Join Matrix guide]

== Setting up ==

=== Homeserver address for clients ===
When logging in to clients, you'll have to provide your homeserver address. This is <code>matrix.pub.solar</code>, '''not''' <code>chat.pub.solar</code>.

The client ''Element X'' requires <code>pub.solar</code> as a server address instead.

=== Saving your encryption keys ===
The first time you log in, you'll be asked to save your encryption keys. ''Make sure to write these down in a secure location!'' We recommend using a password manager. Matrix messages are end-to-end encrypted, which means that the administrators of pub.solar cannot read their contents. However, if you lose your encryption keys you'll lose access to all previous messages.

=== Cross-device verification ===

Cross-device verification lets you share keys between devices, allowing two trusted devices to automatically be trusted by your contacts. The process is straightforward, either by scanning a QR code, or manually compare a few emojis (or words) to make sure both your devices show the same set. To learn more, read the [https://element.io/features/device-verification overview] or the [https://element.io/help#encryption11 guide] by Element.

Initiating this process differs per client.

* On Element, cross-device verification is prompted when you log into a new device.

== Bridging ==

Proprietary chat services such as Discord, Telegram, and WhatsApp can be bridged to Matrix, allowing you to communicate with users on the target network.

Currently, we offer Telegram and IRC bridges for our users. Otherwise, several public bridges are available, such as [https://t2bot.io t2bot] for Discord and Telegram.

=== Telegram ===

Currently, only puppeting is enabled on this instance.

To set up puppeting for your Telegram account:
# Create a direct chat with [https://matrix.to/#/@telegrambot:pub.solar @telegrambot:pub.solar] and wait for it to join.
# Initiate the process by sending <code>login</code>.
# Either follow the link replied to log in via browser, or send your account's phone number directly to the chat.
# Follow further instructions from the bot.

Relay bridging (used to bridge rooms) may be set up in the future.

=== IRC ===

As of January 2024, [https://github.com/matrix-org/matrix-appservice-irc IRC bridging] to [https://libera.chat/ Libera Chat] (irc.libera.chat) and [https://interviewfor.red/en/starting.html Scratch IRC] (irc.scratch-network.net) is enabled.

Before reading on, try searching the public room list in your Matrix client to see if there is already an existing bridged room for the IRC channel you would like to join.

To join a channel on IRC from Matrix, simply join the room <code>#_<SERVER>_<CHANNEL></code>, where <code><nowiki><SERVER></nowiki></code> and <code><nowiki><CHANNEL></nowiki></code> correspond to the IRC server and channel on that IRC server.

For example, to join the channel #pkgsrc on libera.chat IRC, join the Matrix room [https://matrix.to/#/#_libera_#pkgsrc:pub.solar #_libera_#pkgsrc:pub.solar]. One way of joining this room is by entering the following command in the chat box of any room in your Matrix client:
/join #_libera_#pkgsrc:pub.solar

To check the IRC bridge status and to control your connection to IRC servers, start a chat with [https://matrix.to/#/@irc_bot:pub.solar @irc_bot:pub.solar]. This is your [https://matrix-org.github.io/matrix-appservice-irc/latest/admin_room.html IRC bridge admin room], where you can set your IRC Nick (username) and store a password if you registered a user on a given IRC server. ''Note that some IRC channels only allow registered users to join.'' Type <code>!help</code> in the chat box to find out available commands in the admin room.

{| class="wikitable"
|+Table of bridged IRC networks
!Network Name
!Room alias format
!Appservice user
|-
|libera.chat
|<code>#_libera_#channame:pub.solar</code>
|[https://matrix.to/#/@irc.libera.chat_NickServ:pub.solar @irc.libera.chat_NickServ:pub.solar]
|-
|Scratch
|<code>#_scratch_#channame:pub.solar</code>
|[https://matrix.to/#/@irc.scratch-network.net_NickServ:pub.solar @irc.scratch-network.net_NickServ:pub.solar]
|}
To check if the number of bridged IRC servers has changed in the mean time, inspect [https://git.pub.solar/pub-solar/infra/src/branch/main/hosts/nachtigall/apps/matrix/irc.nix the Nix configuration] and look for the entries below the line that says: <code>in {</code>.

== Tips and Tricks ==

=== Enabling the sticker picker ===

To enable the stickerpicker in Element:

# Type <code>/devtools</code> in any chat, and press Enter. [[File:20240922_16h56m33s_grim.png|alt=Screenshot of /devtools|914x914px]]
# Under <code>Other</code>, click <code>Explore account data</code>. [[File:Element-devtools-1.png|alt=Screenshot of Element devtools|914x914px]]
# Click <code>Send custom account data event</code>[[File:Element-devtools-account-data.png|alt=Screenshot of Element devtools, explore account data section|914x914px]]
# Enter <code>m.widgets</code> as Event Type [[File:Element-devtools-widgets.png|alt=Element devtools with widget event type|914x914px]]
# For the Event Content, copy and paste the following JSON text, and replace <code><your-username></code> with your username:
<pre>
{
"stickerpicker": {
"content": {
"type": "m.stickerpicker",
"url": "https://stickers.chat.pub.solar/?theme=$theme",
"name": "Stickerpicker",
"creatorUserId": "@<your-username>:pub.solar",
"data": {}
},
"sender": "@<your-username>:pub.solar",
"state_key": "stickerpicker",
"type": "m.widget",
"id": "stickerpicker"
}
}
</pre>
[[File:Element-devtools-event-sent.png|alt=Element devtools, showing "event sent"|914x914px]][[File:Element-chat-select-stickers.png|alt=Element Chat showing sticker picker button|914x914px]]

Source: [https://github.com/maunium/stickerpicker/wiki/Enabling-the-widget]

== Privacy ==

For the latest information, visit our [https://pub.solar/privacy privacy policy].

=== Deleted events, rooms and media retention ===

Deleted events (e.g. chat messages) are retained for 7 days before being deleted from the database.

Deleted rooms are also retained for 7 days.

Remote media from other homeservers will be deleted after 14 days without accessing it.

== Clients ==

While the official client application is [https://en.wikipedia.org/wiki/Element_(software) Element] ([https://chat.pub.solar/ chat.pub.solar]), you can also use other applications to access Matrix, which may offer different features, a different appearance, and may be more catered to a specific platform.

An officially maintained list of clients can be found at the [https://matrix.org/ecosystem/clients/ Matrix.org ecosystem page].

How-to: Maintenance Announcement

2025-02-10T18:55:59Z

172.17.0.1: Initial How-To for Maintenance Announcements

Example markdown text for a maintenance announcement in our Matrix chat room [https://matrix.to/#/#general:pub.solar #general:pub.solar].
📢 **Maintenance announcement**

**Subject:** Short maintenance for security updates:

```
forgejo: 7.0.11 → 7.0.12
matrix-synapse: 1.120.2 → 1.121.1
nextcloud: 29.0.9 → 29.0.10
```

Affected pub.solar services with short downtime:
- Forgejo (Git) <nowiki>https://git.pub.solar</nowiki>
- Matrix <nowiki>https://chat.pub.solar</nowiki>
- Mastodon <nowiki>https://mastodon.pub.solar</nowiki>
- Nextcloud <nowiki>https://cloud.pub.solar</nowiki>

Starting now.

Check our [status page](<nowiki>https://stats.uptimerobot.com/G28ByiBg8j</nowiki>) for updates.

How-to: Moderation

2025-02-10T14:17:21Z

172.17.0.1:

=== Making a moderation decision ===
Moderation decisions should be made in consensus with all other moderators. Moderation decisions should preferably be logged, tho we do not have a set place yet where this can happen.

=== Onboarding a new moderator ===
# Add them to the Moderation channel on Matrix
# Give them moderation rights in all relevant services
## Mastodon
## Matrix (#hakken and #general)
#Write their name on the wiki page
# Announce the change on community channels & mastodon

=== Offboarding a moderator ===

# Remove their moderation rights in all relevant services
## Mastodon
## Matrix (#hakken and #general)
# Remove them from the Moderation channel on Matrix
# Remove their name from the wiki page
# Announce the change on community channels & mastodon

[[Category:How-To]]
[[Category:Community]]