Repository files navigation

Feature-complete rooms-based chat for tens of thousands users. Client plus Server. Built withOat++ Web Framework.
Single-NodeIn-MemoryWebSocketTLS.

• Run your own chat in Docker:

  docker run -p 8443:8443 -e EXTERNAL_ADDRESS=localhost -e EXTERNAL_PORT=8443 -it lganzzzo/canchat

• Build from source

All communication happens in chat-rooms.
Each room has a unique URL.
Anyone who has room-URL can join the room.Generating random long enough room-URL gives privacy to participants. Be sure to share room-URL with wanted participants only.

Rooms are automatically created when the first participant joins the room, andare automatically deleted when the last participant leaves the room.

Chat-history is available for newly joined participants.History is rounded when the number of messages in the room exceeds themaxRoomHistoryMessages config parameter.History is deleted and no-longer-available once the room is deleted.

Users can share multiple files at once.

Files are streamed directly from the host-peer machine.Nothing is uploaded to the server nor stored in any 3d-party place.

Once host-peer cancels file-sharing, files are no longer available.
If host-peer exits the room, all of his file-sharing is canceled.

• InstallLibreSSL version3.0.0 or later.
• Installoatpp - Oat++ Web Framework (main module)
• Installoatpp-websocket - Oat++ WebSocket extension module.
• Installoatpp-libressl - Libressl adaptor for Oat++.

To install oatpp modules you can useutility/install-oatpp-modules.sh script

$cd<this-repo>/server/$ mkdir build/&&cd build/$ cmake ..$ make

Now run chat server

$ canchat-exe --host localhost --port 8443

$ docker build -t canchat.$ docker run -p 8443:8443 -e EXTERNAL_ADDRESS=localhost -e EXTERNAL_PORT=8443 -it canchat

Then gotohttps://localhost:8443/ in browser. (accept self-signed certificate)

Image parameters:

• -e EXTERNAL_ADDRESS - Address to which the client is supposed to connect to.
• -e EXTERNAL_PORT - Port atEXTERNAL_ADDRESS to which the client is supposed to connect to.Chat server will also be running on this port.
• -e TLS_FILE_PRIVATE_KEY - Path to TLS private-key file.
• -e TLS_FILE_CERT_CHAIN - Path to TLS certificate chain file.

- front/                            # - Front-end sources are here- server/                           # - Server sources are here- cert/                             # - test TLS certificate is here- utility/    |    |- install-oatpp-modules.sh     # - useful script to install required oatpp modules

This project is released underApache License 2.0.

Enjoy!