- secure, easy, self-hosted messaging is an open specification for a new Saltpack based e2e encrypted messaging protocol and platform for secure communications with a focus on privacy, security and being self-hosted.

๐ŸŽฌ Demo


๐Ÿƒโ€ Quick Start

  1. Install salty-chat
  2. Create and register an account
  3. Start chatting!
$ go install
$ salty-chat register <nick>
$ salty-chat chat

Replace <nick> with a nickname / alias you’d like.

To test that everything is working you can talk to our echo bot, for example by starting a chat with it will echo anything you message it:

$ salty-chat chat

Note: This quick start installs our reference command-line client salty-chat and registers an account on the broker running at

Security Warning: Please note that your IP address is logged and that is the personal infrastructure of James Mills.

For full documentation onw how to setup your own broker, with own domain on your own infrastructure (preferred), please read on…

๐Ÿ‘‰ Documentation

The following is more details documentation on setting up your Domain Name (DNS) records (optional) and running our reference broker saltyd on your own server and configuring our reference client salty-chat:

  1. Make sure you have a Domain Name Choosing a Registrar
  2. Read the full instructions and start chatting!

๐ŸŒ Choosing a Registrar

There are numerous Domain Name Registrars you can choose from to register a domain name. It really doesn’t matter which one you use, but you do need a domain name to use Salty IM. Salty IM will also work with a sub-domain (a name under someone else’s domain).

Some reputable registrars include:

Once you have a domain name you will also need to run a small Web Server on it so that Salty Addresses can be looked up automatically by the Discovery process.

As Salty IM is decentralised this is an important step. If you cannot for some reason obtain a domain name and run a small web server, there are other options (see below).

โ‰ Help! What?!

Okay if you don’t understand anything about Domains and Web Servers don’t worry!

We’ve got you covered! Currently you can skip these steps and just install Salty straight away and just following the setup process. Although we highly encourage you to setup your own domain and server as Salty IM is designed to be decentralised, we realize this is not for everyone. By default Salty IM will use publicly available free servers so you don’t need to worry about this.

๐Ÿ“• Specification

๐Ÿ’พ Sources

The project is managed by a self-hosted Gitea instance at

๐Ÿ’ฌ Collaboration

We have an IRC channel on the Libera.Chat IRC network. You are welcome to come chat to us, hang out and get involved!

For your convenience you may use the Web Chat.

๐Ÿ•ต๏ธโ€โ™‚๏ธ PrivacyPolicy

Salty.IM is a decentralised instant messaging protocol inspired by IndieWeb and Twtxt and accompanying project of

Like there is a reference broker (server) and client(s) such as the command-line client salty-chat and a mobile app.

The privacy policy therefore only strictly applies to the reference broker and clients (including the mobile app) built and provided by the Salty.Im developers.

๐Ÿ‘จโ€โš–๏ธ License

Salty IM and Salty Chat are licensed under the terms of the MIT License.