randogoth/smol.place
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Carrier downloads, bunshin deployment and gsmol webmail details to landing page

Browse source
This commit is contained in:
randogoth 2026-10-09 13:17:49 +03:00
parent 6939790caa
commit f9b18218ef
1 changed files with 20 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

25
index.md
View file

@ -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