mirror of
https://gitlab.com/famedly/conduit.git
synced 2024-12-27 21:13:47 +03:00
docs: small readme changes
This commit is contained in:
parent
bd6507eafb
commit
bb1064ce04
1 changed files with 25 additions and 24 deletions
49
README.md
49
README.md
|
@ -1,25 +1,43 @@
|
||||||
# Conduit
|
# Conduit
|
||||||
### A Matrix homeserver written in Rust
|
### A Matrix homeserver written in Rust
|
||||||
|
|
||||||
[![Liberapay](https://img.shields.io/liberapay/receives/timokoesters?logo=liberapay)](https://liberapay.com/timokoesters)
|
|
||||||
[![Matrix](https://img.shields.io/matrix/conduit:conduit.rs?server_fqdn=conduit.koesters.xyz)](https://matrix.to/#/#conduit:matrix.org)
|
|
||||||
|
|
||||||
#### What is the goal?
|
#### What is the goal?
|
||||||
|
|
||||||
A fast Matrix homeserver that's easy to set up and just works. You can install
|
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,
|
it on a mini-computer like the Raspberry Pi to host Matrix for your family,
|
||||||
friends or company.
|
friends or company.
|
||||||
|
|
||||||
|
|
||||||
#### Can I try it out?
|
#### Can I try it out?
|
||||||
|
|
||||||
Yes! Just open a Matrix client (<https://app.element.io> or Element Android for
|
Yes! Just open a Matrix client (<https://app.element.io> or Element Android for
|
||||||
example) and register on the `https://conduit.koesters.xyz` homeserver.
|
example) and register on the `https://conduit.koesters.xyz` homeserver.
|
||||||
|
|
||||||
|
|
||||||
|
#### 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
|
||||||
|
|
||||||
|
|
||||||
|
#### What are the biggest things still missing?
|
||||||
|
|
||||||
|
- Most federation features (invites, e2ee)
|
||||||
|
- Push notifications on mobile
|
||||||
|
- Notification settings
|
||||||
|
- Lots of testing
|
||||||
|
|
||||||
|
Check out the [Conduit 1.0 Release Milestone](https://gitlab.com/famedly/conduit/-/milestones/3).
|
||||||
|
|
||||||
|
|
||||||
#### How can I deploy my own?
|
#### How can I deploy my own?
|
||||||
|
|
||||||
##### Deploy
|
##### Deploy
|
||||||
|
|
||||||
Download or compile a conduit binary and call it from somewhere like a systemd script. [Read
|
Download or compile a Conduit binary, set up the config and call it from somewhere like a systemd script. [Read
|
||||||
more](DEPLOY.md)
|
more](DEPLOY.md)
|
||||||
|
|
||||||
##### Deploy using Docker
|
##### Deploy using Docker
|
||||||
|
@ -33,32 +51,15 @@ docker run -d -p 8448:8000 -v db:/srv/conduit/.local/share/conduit matrixconduit
|
||||||
|
|
||||||
Or build and run it with docker or docker-compose. [Read more](docker/README.md)
|
Or build and run it with docker or docker-compose. [Read more](docker/README.md)
|
||||||
|
|
||||||
#### 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
|
|
||||||
|
|
||||||
#### What are the biggest things still missing?
|
|
||||||
|
|
||||||
- Appservices (Bridges and Bots)
|
|
||||||
- Most federation features (invites, e2ee)
|
|
||||||
- Push notifications on mobile
|
|
||||||
- Notification settings
|
|
||||||
- Lots of testing
|
|
||||||
|
|
||||||
Also check out the [milestones](https://git.koesters.xyz/timo/conduit/milestones).
|
|
||||||
|
|
||||||
#### How can I contribute?
|
#### How can I contribute?
|
||||||
|
|
||||||
1. Look for an issue you would like to work on and make sure it's not assigned
|
1. Look for an issue you would like to work on and make sure it's not assigned
|
||||||
to other users
|
to other users
|
||||||
2. Ask someone to assign the issue to you (comment on the issue or chat in
|
2. Ask someone to assign the issue to you (comment on the issue or chat in
|
||||||
#conduit:matrix.org)
|
#conduit:nordgedanken.dev)
|
||||||
3. Fork the repo and work on the issue. #conduit:matrix.org is happy to help :)
|
3. Fork the repo and work on the issue. #conduit:nordgedanken.dev is happy to help :)
|
||||||
4. Submit a PR
|
4. Submit a MR
|
||||||
|
|
||||||
#### Donate
|
#### Donate
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue