646b892680
Some checks failed
Periodic Merges (6h) / master → staging-nixos (push) Failing after 12m50s
Periodic Merges (6h) / master → staging-next (push) Failing after 12m54s
Periodic Merges (24h) / merge-base(master,staging) → haskell-updates (push) Failing after 11m54s
Periodic Merges (6h) / staging-next → staging (push) Failing after 12m13s
Periodic Merges (24h) / staging-next-25.05 → staging-25.05 (push) Failing after 13m24s
Periodic Merges (24h) / release-25.05 → staging-next-25.05 (push) Failing after 14m28s
33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
# Mautrix-Signal {#module-services-mautrix-signal}
|
|
|
|
[Mautrix-Signal](https://github.com/mautrix/signal) is a Matrix-Signal puppeting bridge.
|
|
|
|
## Configuration {#module-services-mautrix-signal-configuration}
|
|
|
|
1. Set [](#opt-services.mautrix-signal.enable) to `true`. The service will use
|
|
SQLite by default.
|
|
2. To create your configuration check the default configuration for
|
|
[](#opt-services.mautrix-signal.settings). To obtain the complete default
|
|
configuration, run
|
|
`nix-shell -p mautrix-signal --run "mautrix-signal -c default.yaml -e"`.
|
|
|
|
::: {.warning}
|
|
Mautrix-Signal allows for some options like `encryption.pickle_key`,
|
|
`provisioning.shared_secret`, allow the value `generate` to be set.
|
|
Since the configuration file is regenerated on every start of the
|
|
service, the generated values would be discarded and might break your
|
|
installation. Instead, set those values via
|
|
[](#opt-services.mautrix-signal.environmentFile).
|
|
:::
|
|
|
|
## Migrating from an older configuration {#module-services-mautrix-signal-migrate-configuration}
|
|
|
|
With Mautrix-Signal v0.7.0 the configuration has been rearranged. Mautrix-Signal
|
|
performs an automatic configuration migration so your pre-0.7.0 configuration
|
|
should just continue to work.
|
|
|
|
In case you want to update your NixOS configuration, compare the migrated configuration
|
|
at `/var/lib/mautrix-signal/config.yaml` with the default configuration
|
|
(`nix-shell -p mautrix-signal --run "mautrix-signal -c example.yaml -e"`) and
|
|
update your module configuration accordingly.
|