From f9b18218ef8e11ab3c729204d8462eef7b206623 Mon Sep 17 00:00:00 2001 From: randogoth Date: Fri, 9 Oct 2026 13:17:49 +0300 Subject: [PATCH] docs: add Carrier downloads, bunshin deployment and gsmol webmail details to landing page --- index.md | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/index.md b/index.md index dbd5ec4..6fd47f8 100644 --- a/index.md +++ b/index.md @@ -24,13 +24,17 @@ A small, decentralised mail system where every message is encrypted end to end. ### Use webmail -Go to [webmail.smol.place](https://webmail.smol.place) to register a @smol.place address and start sending encrypted mail. Nothing to install. - -A browser client depends on the site that serves it, because the code is loaded fresh each time you open the page. For long-term use, a native client that pins our server key gives you stronger guarantees. +Go to [webmail.smol.place](https://webmail.smol.place) to register a @smol.place address and start sending encrypted mail. Nothing to install. It runs [gsmol](https://code.randogoth.com/randogoth/gsmol), which does all its encryption in your browser. ### Use a native client -Connect to `smol.place` on port `1961`, and pin this server key before you connect: +Download **Carrier**, a smolmail client for your computer: + +- [Linux](https://code.randogoth.com/randogoth/carrier/releases/download/v0.2.0/carrier-linux-x86_64) or [Linux Flatpak](https://code.randogoth.com/randogoth/carrier/releases/download/v0.2.0/carrier-x86_64.flatpak) +- [Windows installer](https://code.randogoth.com/randogoth/carrier/releases/download/v0.2.0/carrier-windows-0.2.0-setup.exe) +- [All releases](https://code.randogoth.com/randogoth/carrier/releases) + +Connect to `smol.place` and confirm this server key before you connect: > `po3cxpzjrt73dypt2rplskbkywizr44afhqthaa5x47mfpe4kesq` @@ -89,7 +93,18 @@ Messages don't stay on the server forever. Mail in your main mailbox is kept for Servers never talk to each other. Each one is an independent mailbox store, so running one is a small job. Anyone with a smolmail address can write to anyone on any other server. -The [reference client and server](https://code.randogoth.com/randogoth/smolmail) are written in Python, for both TCP and Reticulum. The [gsmol](https://code.randogoth.com/randogoth/gsmol) bridge carries smolmail over WebSocket. +[bunshin](https://code.randogoth.com/randogoth/bunshin) is a smolmail server written in Rust. To start one with Podman or Docker, run: + +``` +podman run -d --name bunshin \ + -p 1961:1961 \ + -v bunshin-data:/data \ + code.randogoth.com/randogoth/bunshin +``` + +On first start, bunshin creates a server key. Run `podman logs bunshin` to see its public key, then publish it somewhere your users trust, so their clients can pin it. Restarts and upgrades keep the same key. The bunshin page also covers NixOS, hosting several domains on one server, and Reticulum. + +The [reference client and server](https://code.randogoth.com/randogoth/smolmail) are written in Python, for both TCP and Reticulum. [gsmol](https://code.randogoth.com/randogoth/gsmol) is a webmail client you can host yourself. It runs entirely in the browser and reaches mail servers through a small WebSocket bridge. ## Specification