Note: Currently you will need the Go toolchain installed as we don’t publish binaries yet.

Client-side

1. Run go install go.mills.io/saltyim/cmd/salty-chat@latest
2. Add $GOPATH/bin to your $PATH with:

# This is most likely already set by the toolchain itself
export $GOPATH="$HOME/go"

# This is what you should actually do
export PATH="$PATH:$GOPATH/bin"

3. Run salty-chat make-user <username> <broker-url> or if a saltyd endpoint exists, then use salty-chat register <username>@<host> <broker-url> instead

or

1. Install msgbus, salty and salty-keygen with:

go install git.mills.io/prologic/msgbus/cmd/msgbus@latest
go install go.mills.io/salty/cmd/salty@latest
go install go.mills.io/salty/cmd/salty-keygen@latest

2. Install jq either from source or from your distribution’s or OS’s package manager.

3. Fetch the salty-chat.sh script and place it somewhere accessible into your $PATH with the proper execution bit set (mode 0755)

4. Run salty-chat.sh make-user <username>@<host> or if a saltyd endpoint exists, then use salty-chat.sh register <username>@<host> instead.

Server-side

Deployment of a saltyd broker may vary between platforms, the following being listed below:

• FreeBSD (coming soon)
• Linux with Docker
• Linux without Docker
• OpenBSD

How to request SSL/TLS certificates and such won’t be covered by this guide.