Awiteb
0f146a5df8
Because rustdoc lint us with `broken_intra_doc_links` Signed-off-by: Awiteb <a@4rs.nl>
4.3 KiB
Oxidetalis
An open-source OxideTalis Messaging Protocol (OTMP) homeserver implementation written in Rust.
Warning
The project is still in very early development and is not ready for any kind of use yet, the protocol is not finalized and the server is not feature complete, also not all protocol features are implemented yet.
About
OTMP is a federated chat protocol that aims to be a secure and
privacy-respecting alternative to existing chat protocols, OTMP does not
rely on a central server, but instead uses a federated network of servers to
deliver messages. When you send a message to a friend, you will connect to your
friend's server and send the message directly to them. This way, your messages
are not stored on a central server, and only you and your friend can read them.
Key Features
- Federated: No central server, messages are sent directly to the recipient server by you.
- End-to-End Encryption: Messages are encrypted on the client and decrypted on the client.
- Self-Hosted: You can host your own server and have full control over your data.
- Privacy-Respecting: No tracking, no ads, no data mining, no email/usernames/passwords required.
- Secure: Messages are encrypted and signed, and the protocol is designed to be secure.
- Lightweight: Simple protocol, easy to implement, easy to use. No bloat.
Protocol non-goals
- Group chats
- Voice/video calls
How to authenticate without usernames and passwords
OTMP uses a different authroization mechanism than most chat protocols.
Instead of using usernames and passwords, OTMP uses public/private key pairs
to authenticate users. When you create an account, you generate a key pair on
your device, and the public key is sent to the server. When you sent a request
to the server, you sign the request with shared secret key between you and the
server. This way, the server can verify that the request is coming from you and
authroize the request.
E2EE, how does it work?
OTMP key pairs are used for more than just authroization, they are also used
for end-to-end encryption. When you send a message to a friend, you encrypt the
message with shared secret key, the shared secret key is generated by
diffie-hellman key exchange using your private key and your friend's public key.
This way, only you and your friend can read the message, even the server can't
read it.
Running the server
Note
You must update
OXIDETALIS_CONFIGin thedocker-compose.ymlfile to point to the correct configuration file. And you must update the configuration file.
To run the server, you need to have docker and docker-compose installed on your system. You can run the server by running the following command:
docker-compose up -d
Contributing
For information on how to contribute to the project, please see the CONTRIBUTING.md file.
Repository mirrors
Licenses
The project is split into multiple crates, each with its own license:
crates/oxidetalis: Homeserver implementation, licensed under the GNU AGPLv3.crates/oxidetalis_config: Configuration library, licensed under the MIT license.crates/oxidetalis_core: The core library, licensed under the MIT license.crates/migrations: Database migrations, licensed under the MIT license.crates/entities: Database entities, licensed under the MIT license.