2022-09-25 02:52:51 +00:00
|
|
|
# Salty IM -- secure, easy, self-hosted messaging
|
2022-03-19 05:43:43 +00:00
|
|
|
|
2022-03-26 00:48:01 +00:00
|
|
|
[](https://ci.mills.io/saltyim/saltyim)
|
2022-09-25 02:52:51 +00:00
|
|
|
[](https://goreportcard.com/report/git.mills.io/saltyim/saltyim)
|
2023-02-27 22:37:41 +00:00
|
|
|
[](https://pkg.go.dev/go.salty.im/saltyim)
|
2022-03-21 04:37:31 +00:00
|
|
|
|
2022-09-25 03:00:55 +00:00
|
|
|
<p align="center">
|
|
|
|
|
<img src="https://git.mills.io/saltyim/saltyim/media/branch/master/docs/logo.png" alt="SaltyIM Logo" />
|
|
|
|
|
</p>
|
2022-03-19 05:43:43 +00:00
|
|
|
|
2022-09-25 02:52:51 +00:00
|
|
|
[Salty IM](https://salty.im) is a secure, decentrlaised and easy self-hosted
|
|
|
|
|
instant messaging alternative. Salty IM is fully encrypted using the
|
|
|
|
|
[salty](https://git.mills.io/prologic/salty) Go library utilising the
|
|
|
|
|
[Saltypack](https://saltpack.org/) messaging format and parts of
|
|
|
|
|
[keys.pub](https://keys.pub/) implemtnation for its cryptography.
|
|
|
|
|
Encryption, Decryption and Signing of messages is performed with public key
|
|
|
|
|
cryptography using the Ed25519 algoritms.
|
|
|
|
|
|
|
|
|
|
For more information on how the protocol works, please refer to the
|
|
|
|
|
[Specification](https://salty.im/spec.html).
|
|
|
|
|
|
|
|
|
|
This repository also contains a reference client (written in Go), a reference
|
|
|
|
|
broker (server) as well as a Terminal TUI (TUI) client called `salty-chat` and
|
|
|
|
|
command-line tools:
|
|
|
|
|
|
|
|
|
|
- `saltyd` -- Reference broker (server)
|
|
|
|
|
- `salty-chat` -- Command-line tools and Terminal UI (TUI)
|
2023-02-27 22:37:41 +00:00
|
|
|
- [saltyim](https://pkg.go.dev/go.salty.im/saltyim) -- Reference client (Go library)
|
2022-09-25 02:52:51 +00:00
|
|
|
|
|
|
|
|
## Quick Start CLI
|
|
|
|
|
|
|
|
|
|
```console
|
2023-02-27 22:37:41 +00:00
|
|
|
$ go install go.salty.im/saltyim/cmd/salty-chat@latest
|
2022-03-19 13:05:36 +00:00
|
|
|
$ salty-chat make-user user@domain
|
2022-06-12 02:49:19 +00:00
|
|
|
# Follow the insturctions
|
2022-03-19 05:48:42 +00:00
|
|
|
$ salty-chat chat prologic@mills.io
|
2022-03-19 05:43:43 +00:00
|
|
|
```
|
|
|
|
|
|
2022-06-12 02:49:19 +00:00
|
|
|
Alternatively follow the full documentation below to setup your own Salty
|
|
|
|
|
broker and your domain name.
|
|
|
|
|
|
|
|
|
|
## Quick Start (DEV)
|
|
|
|
|
|
2022-03-23 00:16:52 +00:00
|
|
|
## Documentation
|
2022-03-19 05:43:43 +00:00
|
|
|
|
2022-09-25 02:52:51 +00:00
|
|
|
> See also the [Old Readme](./OLDREADME.md) for how this
|
2022-06-12 02:52:03 +00:00
|
|
|
> implementation started out as a simple shell script which you can still
|
|
|
|
|
> find at [salty-chat.sh](./bin/salty-chat.sh).
|
2022-03-19 05:43:43 +00:00
|
|
|
|
2022-06-12 02:52:03 +00:00
|
|
|
- [Deployment Guide](./docs/Deployment.md)
|
|
|
|
|
- [Development Guide](./docs/Development.md)
|
2022-04-26 01:44:51 +00:00
|
|
|
|
2022-03-23 00:16:52 +00:00
|
|
|
## Roadmap
|
2022-03-16 12:45:16 +00:00
|
|
|
|
2022-03-23 00:16:52 +00:00
|
|
|
Please refer to the [Roadmap](./Roadmap.md) document.
|
2022-03-16 12:45:16 +00:00
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
2022-09-25 02:52:51 +00:00
|
|
|
`saltyd` and `salty-chat` are licensed under the terms of the [MIT](/LICENSE)
|
|
|
|
|
license.
|
