SolarOS 4.6.8 manual · job

chatd

Local SolarOS chat gateway server. It is useful for testing the chat app or for small trusted local networks.

Usage:

job start chatd [port] [token] [--history path]
job start chatd [port] [token] [path]
job stop chatd
job status chatd

Defaults:

Setting	Value
Port	`7777`
Default channel	`general`
Maximum clients	`6`
Maximum channels	`32`
In-memory history	`64` events

Arguments are intentionally flexible. The first numeric argument is the port. The next non-option argument is the optional token. --history or --log selects an optional append-only history dump file.

Examples:

job start chatd
job start chatd 7777 secret
job start chatd 7777 secret --history /.shell/chatd.log

The local chat app can connect with:

chat local
chat 127.0.0.1:7777

On another SolarOS device or host on the same network, use the server IP:

chat 192.168.1.113:7777

Notes:

If a token is configured, clients must present the same token.
New clients receive the recent in-memory channel history.
Channel deletion is supported by the chat protocol and client.
The built-in server is a lightweight LAN gateway, not a hardened public chat

service.