Getting Started

Get a Llamenos hotline running locally or on a server. Only Docker is required — no Node.js, Bun, or other runtimes needed.

How it works

When someone calls your hotline number, Llamenos routes the call to all on-shift volunteers simultaneously. The first volunteer to answer gets connected, and the others stop ringing. After the call ends, the volunteer can save encrypted notes about the conversation.

flowchart TD
    A["Incoming Call"] --> B{"Shift Active?"}
    B -->|Yes| C["Ring All On-Shift Volunteers"]
    B -->|No| D["Ring Fallback Group"]
    C --> E{"First Pickup"}
    D --> E
    E -->|"Answered"| F["Connect Call"]
    E -->|"No Answer"| G["Voicemail"]
    F --> H["Save Encrypted Note"]

The same routing applies to SMS, WhatsApp, and Signal messages — they appear in a unified Conversations view where volunteers can respond.

Prerequisites

• Docker with Docker Compose v2
• openssl (pre-installed on most Linux and macOS systems)
• Git

Quick start

git clone https://github.com/rhonda-rodododo/llamenos.git
cd llamenos
./scripts/docker-setup.sh

This generates all required secrets, builds the application, and starts the services. Once complete, visit http://localhost:8000 and the setup wizard will guide you through:

1. Create your admin account — you’ll receive an invite link from your organization’s identity provider (Authentik). Click the link, set up your credentials, and your admin account is provisioned automatically.
2. Name your hotline — set the display name
3. Choose channels — enable Voice, SMS, WhatsApp, Signal, and/or Reports
4. Configure providers — enter credentials for each enabled channel
5. Review and finish

Try demo mode

To explore with pre-seeded sample data and one-click login (no account creation needed):

./scripts/docker-setup.sh --demo

Production deployment

For a server with a real domain and automatic TLS:

./scripts/docker-setup.sh --domain hotline.yourorg.com --email admin@yourorg.com

Caddy automatically provisions Let’s Encrypt TLS certificates. Make sure ports 80 and 443 are open. The --domain flag activates the production Docker Compose overlay, which adds TLS, log rotation, and resource limits.

See the Docker Compose deployment guide for full details on server hardening, backups, monitoring, and optional services.

Core services

The Docker setup starts six core services:

Configure webhooks

After deploying, point your telephony provider’s webhooks to your deployment URL:

For provider-specific setup: Twilio, SignalWire, Vonage, Plivo, Asterisk, SMS, WhatsApp, Signal.

Next steps

• Docker Compose Deployment — full production deployment guide with backups and monitoring
• Admin Guide — add volunteers, create shifts, configure channels and settings
• Volunteer Guide — share with your volunteers
• Telephony Providers — compare voice providers
• Security Model — understand the encryption and threat model