How-To Guides

Practical recipes for common tasks. Each guide focuses on a single goal and assumes you already have Titlani installed.

• Generate Identities

  ---

  Create and inspect Misfin identity certificates via CLI or Python.

  Guide

• Configure Server

  ---

  Write a TOML config file, set CLI overrides, and manage auto-generated certs.

  Guide

• Manage TOFU

  ---

  List, revoke, and programmatically manage the Trust-On-First-Use database.

  Guide

• Rate Limiting

  ---

  Configure token bucket rate limiting to protect your server.

  Guide

• Access Control

  ---

  Set up IP allow/deny lists for your server.

  Guide

• Sender Verification

  ---

  Verify that senders actually exist on their claimed server.

  Guide

• Contact Blocking

  ---

  Block specific sender addresses from delivering to a mailbox.

  Guide

• Auto-Reply

  ---

  Set up automatic out-of-office replies for a mailbox.

  Guide

• At-Rest Encryption

  ---

  Encrypt stored messages with per-mailbox X25519 keys.

  Guide

• Mailing Lists

  ---

  Create server-side mailing lists with subscriber management and message forwarding.

  Guide

• GMAP (Remote Mailbox Access)

  ---

  Enable remote mailbox access over Gemini protocol with tag management.

  Guide

• Deploy to Production

  ---

  End-to-end guide for systemd and Docker deployments, client setup, and troubleshooting.

  Guide

• Custom Message Handler

  ---

  Subclass MessageHandler to implement custom delivery logic.

  Guide

• Compose Gemmail

  ---

  Build, parse, and serialize gemmail messages programmatically.

  Guide