oxidetalis/README.md
Awiteb a9ba2c4f31
chore: Add README.md
Signed-off-by: Awiteb <a@4rs.nl>
2024-06-26 23:05:06 +03:00

97 lines
4.1 KiB
Markdown

<div align="center">
<img src="https://otmp.4rs.nl/otmp_logo.png" alt="OTMP Logo" width="100"
height="100">
# Oxidetalis
An open-source [OxideTalis Messaging Protocol][`OTMP`] (OTMP) homeserver
implementation written in Rust.
<!-- [![Forgejo CI
Status](https://git.4rs.nl/oxidetalis/oxidetalis/badges/workflows/ci.yml/badge.svg)](https://git.4rs.nl/oxidetalis/oxidetalis)
[![Forgejo CD
Status](https://git.4rs.nl/oxidetalis/oxidetalis/badges/workflows/cd.yml/badge.svg)](https://git.4rs.nl/oxidetalis/oxidetalis) -->
[![agplv3-or-later](https://www.gnu.org/graphics/agplv3-88x31.png)](https://www.gnu.org/licenses/agpl-3.0.html)
</div>
> [!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][`OTMP`].
- **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_CONFIG` in the `docker-compose.yml` file 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:
```sh
docker-compose up -d
```
## Contributing
For information on how to contribute to the project, please see the
[CONTRIBUTING.md](./CONTRIBUTING.md) file.
## 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.
[`OTMP`]: https://otmp.4rs.nl
[`crates/oxidetalis`]: ./crates/oxidetalis
[`crates/oxidetalis_config`]: ./crates/oxidetalis_config
[`crates/oxidetalis_core`]: ./crates/oxidetalis_core
[`crates/migrations`]: ./crates/migrations
[`crates/entities`]: ./crates/entities