SimpleX SMP — One-Click Install

Name: SimpleX SMP
Author: Simplex Team

A reference implementation of the SimpleX Messaging Protocol for simplex queues over public networks.

Social

Why install SimpleX SMP with Web.Casa?

One-Click Deploy

No manual Docker Compose needed. Web.Casa configures and starts everything.

Auto HTTPS

Caddy auto-provisions SSL certificates. Reverse proxy works out of the box.

Unified Management

Monitoring, backups, updates, logs — manage all apps from one panel.

How to Install

Install Web.Casa first, then one-click install this app from the App Store.

App Info

Version: v6.4.5
Author: Simplex Team
Default Port: 5223

Source Code

Initial Setup

To get the SMP Server Address

SSH into your Tipi Server
Run sudo docker logs simplex-smp 2>&1 | grep "Server address:" to find out the SMP Server Address.

📢 SimpleXMQ v1 is released - with many security, privacy and efficiency improvements, new functionality - see release notes.

Please note: v1 is not backwards compatible, but it has the version negotiation built into all protocol layers for forwards compatibility of this version and backwards compatibility of the future versions, that will be backwards compatible for at least two versions back.

If you have a server deployed please deploy a new server to a new host and retire the previous version once it is no longer used.

Message broker for unidirectional (simplex) queues

SimpleXMQ is a message broker for managing message queues and sending messages over public network. It consists of SMP server, SMP client library and SMP agent that implement SMP protocol for client-server communication and SMP agent protocol to manage duplex connections via simplex queues on multiple SMP servers.

SMP protocol is inspired by Redis serialization protocol, but it is much simpler - it currently has only 10 client commands and 8 server responses.

SimpleXMQ is implemented in Haskell - it benefits from robust software transactional memory (STM) and concurrency primitives that Haskell provides.

SimpleXMQ roadmap

SimpleX service protocol and application template - to enable users building services and chat bots that work over SimpleX protocol stack. The first such service will be a notification service for a mobile app.
SMP queue redundancy and rotation in SMP agent connections.
SMP agents synchronization to share connections and messages between multiple agents (it would allow using multiple devices for simplex-chat).

FAQ

Can I install SimpleX SMP on Web.Casa?

Yes, SimpleX SMP is available in the Web.Casa App Store. You can install it with one click from the Web.Casa panel — no need to manually write Docker Compose files or configure reverse proxies.

How do I install SimpleX SMP on Web.Casa?

First install Web.Casa with curl -fsSL https://get.web.casa | bash, then search for "SimpleX SMP" in the App Store and click install. Web.Casa automatically configures the Docker container, assigns ports, and sets up a Caddy reverse proxy.

What is the default port for SimpleX SMP on Web.Casa?

The default port for SimpleX SMP on Web.Casa is 5223. You can bind it to a custom domain through Web.Casa's Caddy reverse proxy, which automatically provisions HTTPS certificates.

Does SimpleX SMP get automatic HTTPS after installation?

Yes. Web.Casa is built on Caddy, so after installing the app, simply bind a domain and Caddy will automatically provision and renew SSL certificates via Let's Encrypt — no manual configuration needed.

How do I back up SimpleX SMP data?

Web.Casa has a built-in backup plugin that supports automatic backups of SimpleX SMP data to local storage, S3, WebDAV, or SFTP. You can configure scheduled snapshots and retention policies to keep your data safe.