conduit/README.md

45 lines
2.0 KiB
Markdown
Raw Normal View History

2020-04-09 15:39:45 +00:00
# Conduit
### A Matrix homeserver written in Rust
2020-04-03 15:53:06 +00:00
2020-04-10 05:53:20 +00:00
[![Liberapay](https://img.shields.io/liberapay/receives/timokoesters?logo=liberapay)](https://liberapay.com/timokoesters)
[![Matrix](https://img.shields.io/matrix/conduit:koesters.xyz?server_fqdn=matrix.koesters.xyz&logo=matrix)](https://matrix.to/#/#conduit:koesters.xyz)
2020-04-08 20:28:03 +00:00
2020-05-29 07:54:30 +00:00
#### What is the goal
A fast Matrix homeserver that's easy to set up and just works. You can install 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
#### Is it fast?
See it in action: <https://www.youtube.com/watch?v=HoBslDtqC1k>
2020-05-29 07:54:30 +00:00
#### Can I try it out?
2020-04-03 15:53:06 +00:00
2020-05-29 07:54:30 +00:00
Yes! Just open <https://riot.conduit.rs> and register on the default homeserver. You can also use <https://riot.im/app> and set the homeserver url to <https://conduit.koesters.xyz:14004> to connect. (BUG: Registration currently doesn't work on riot.im. [Fix](https://github.com/matrix-org/matrix-js-sdk/pull/1304) will come soon)
#### How can I deploy my own?
You just have to clone the repo, build it with `cargo build --release` and call the binary (target/release/conduit) from somewhere like a systemd script.
It's explained in more detail [here](https://git.koesters.xyz/timo/conduit/wiki/Deploy).
2020-04-03 15:53:06 +00:00
#### What is it build on?
- [Ruma](https://www.ruma.io): Useful structures for endpoint requests and responses that can be (de)serialized
- [Sled](https://github.com/spacejam/sled): A simple (key, value) database with good performance
- [Rocket](https://rocket.rs): A flexible web framework
2020-05-29 07:54:30 +00:00
#### What are the biggest things still missing?
- Federation (Make Conduit talk to other Matrix servers)
- Notifications (Make Matrix client notify the user when new messages or pings arrive)
- Lots of testing
2020-04-08 20:28:03 +00:00
2020-05-29 08:04:19 +00:00
Also check out the [milestones](https://git.koesters.xyz/timo/conduit/milestones).
2020-04-12 20:29:48 +00:00
#### How can I contribute?
2020-05-29 07:54:30 +00:00
If you want to help, you may be able to find something in the issue tracker. If you do, comment on the issue, so others know. You can also join #conduit:matrix.org and ask there.
2020-04-12 20:29:48 +00:00
2020-04-08 20:28:03 +00:00
#### Donate
Liberapay: <https://liberapay.com/timokoesters/>