2020-04-09 15:39:45 +00:00
|
|
|
# Conduit
|
|
|
|
|
### A Matrix homeserver written in Rust
|
2020-04-03 15:53:06 +00:00
|
|
|
|
2022-12-18 05:52:18 +00:00
|
|
|
#### What is Matrix?
|
|
|
|
|
[Matrix](https://matrix.org) is an open network for secure and decentralized
|
|
|
|
|
communication. Users from every Matrix homeserver can chat with users from all
|
|
|
|
|
other Matrix servers. You can even use bridges (also called Matrix appservices)
|
|
|
|
|
to communicate with users outside of Matrix, like a community on Discord.
|
|
|
|
|
|
2020-08-12 19:17:53 +00:00
|
|
|
#### What is the goal?
|
2020-05-29 07:54:30 +00:00
|
|
|
|
2021-09-01 11:09:24 +00:00
|
|
|
An efficient Matrix homeserver that's easy to set up and just works. You can install
|
2020-10-18 11:23:06 +00:00
|
|
|
it on a mini-computer like the Raspberry Pi to host Matrix for your family,
|
|
|
|
|
friends or company.
|
2020-05-21 15:36:07 +00:00
|
|
|
|
2020-05-29 07:54:30 +00:00
|
|
|
#### Can I try it out?
|
2020-04-03 15:53:06 +00:00
|
|
|
|
2021-09-01 11:09:24 +00:00
|
|
|
Yes! You can test our Conduit instance by opening a Matrix client (<https://app.element.io> or Element Android for
|
2023-08-09 16:27:30 +00:00
|
|
|
example) and registering on the `conduit.rs` homeserver. The registration token is "for_testing_only". Don't share personal information.
|
2022-12-18 05:52:18 +00:00
|
|
|
|
|
|
|
|
Server hosting for conduit.rs is donated by the Matrix.org Foundation.
|
2021-03-04 14:28:28 +00:00
|
|
|
|
2021-04-20 10:53:20 +00:00
|
|
|
#### What is the current status?
|
2021-03-04 14:28:28 +00:00
|
|
|
|
2022-02-17 20:59:55 +00:00
|
|
|
Conduit is Beta, meaning you can join and participate in most
|
2021-09-01 11:09:24 +00:00
|
|
|
Matrix rooms, but not all features are supported and you might run into bugs
|
|
|
|
|
from time to time.
|
2021-04-20 10:53:20 +00:00
|
|
|
|
|
|
|
|
There are still a few important features missing:
|
|
|
|
|
|
2022-12-18 05:52:18 +00:00
|
|
|
- E2EE emoji comparison over federation (E2EE chat works)
|
|
|
|
|
- Outgoing read receipts, typing, presence over federation (incoming works)
|
2021-03-04 14:28:28 +00:00
|
|
|
|
|
|
|
|
Check out the [Conduit 1.0 Release Milestone](https://gitlab.com/famedly/conduit/-/milestones/3).
|
|
|
|
|
|
2020-05-29 07:54:30 +00:00
|
|
|
#### How can I deploy my own?
|
|
|
|
|
|
2022-02-04 16:57:59 +00:00
|
|
|
- Simple install (this was tested the most): [DEPLOY.md](DEPLOY.md)
|
2023-07-23 10:24:37 +00:00
|
|
|
- Debian package: [debian/README.md](debian/README.md)
|
2022-10-15 22:21:04 +00:00
|
|
|
- Nix/NixOS: [nix/README.md](nix/README.md)
|
2022-02-04 16:57:59 +00:00
|
|
|
- Docker: [docker/README.md](docker/README.md)
|
2021-03-12 20:07:43 +00:00
|
|
|
|
2021-09-01 11:09:24 +00:00
|
|
|
If you want to connect an Appservice to Conduit, take a look at [APPSERVICES.md](APPSERVICES.md).
|
2020-08-04 20:06:13 +00:00
|
|
|
|
2020-04-12 20:29:48 +00:00
|
|
|
#### How can I contribute?
|
|
|
|
|
|
2020-10-18 11:23:06 +00:00
|
|
|
1. Look for an issue you would like to work on and make sure it's not assigned
|
|
|
|
|
to other users
|
|
|
|
|
2. Ask someone to assign the issue to you (comment on the issue or chat in
|
2022-02-04 16:57:59 +00:00
|
|
|
[#conduit:fachschaften.org](https://matrix.to/#/#conduit:fachschaften.org))
|
|
|
|
|
3. Fork the repo and work on the issue.[#conduit:fachschaften.org](https://matrix.to/#/#conduit:fachschaften.org) is happy to help :)
|
2021-03-04 14:28:28 +00:00
|
|
|
4. Submit a MR
|
2020-04-12 20:29:48 +00:00
|
|
|
|
2021-09-02 11:05:19 +00:00
|
|
|
#### Thanks to
|
|
|
|
|
|
2022-12-18 05:52:18 +00:00
|
|
|
Thanks to FUTO, Famedly, Prototype Fund (DLR and German BMBF) and all individuals for financially supporting this project.
|
2021-09-02 11:05:19 +00:00
|
|
|
|
|
|
|
|
Thanks to the contributors to Conduit and all libraries we use, for example:
|
|
|
|
|
|
|
|
|
|
- Ruma: A clean library for the Matrix Spec in Rust
|
2022-01-20 10:51:31 +00:00
|
|
|
- axum: A modular web framework
|
2021-09-02 11:05:19 +00:00
|
|
|
|
2022-12-18 05:52:18 +00:00
|
|
|
#### Contact
|
|
|
|
|
|
|
|
|
|
If you run into any question, feel free to
|
|
|
|
|
- Ask us in `#conduit:fachschaften.org` on Matrix
|
|
|
|
|
- Write an E-Mail to `conduit@koesters.xyz`
|
2023-07-06 08:32:25 +00:00
|
|
|
- Send an direct message to `timokoesters@fachschaften.org` on Matrix
|
2022-12-18 05:52:18 +00:00
|
|
|
- [Open an issue on GitLab](https://gitlab.com/famedly/conduit/-/issues/new)
|
|
|
|
|
|
2020-04-08 20:28:03 +00:00
|
|
|
#### Donate
|
|
|
|
|
|
2020-06-16 06:43:46 +00:00
|
|
|
Liberapay: <https://liberapay.com/timokoesters/>\
|
2020-06-16 06:21:06 +00:00
|
|
|
Bitcoin: `bc1qnnykf986tw49ur7wx9rpw2tevpsztvar5x8w4n`
|
2021-03-04 20:26:30 +00:00
|
|
|
|
|
|
|
|
#### Logo
|
|
|
|
|
|
|
|
|
|
Lightning Bolt Logo: https://github.com/mozilla/fxemoji/blob/gh-pages/svgs/nature/u26A1-bolt.svg \
|
|
|
|
|
Logo License: https://github.com/mozilla/fxemoji/blob/gh-pages/LICENSE.md
|
