Fast anonymous email accounts powered by Bitcoin Lightning Network payments. Get a private disposable email address in seconds - no personal information required, just pay with Bitcoin Lightning and start sending and receiving emails immediately.

• Fast & Anonymous: Get your email address instantly after Bitcoin Lightning payment - no signup, no verification
• Bitcoin-Powered Privacy: Pay with Lightning Network for maximum anonymity and speed
• Send & Receive: Full email functionality with Lightning payments for outgoing messages
• One-Year Duration: Email accounts valid for one year with renewal option
• Secure Access: Token-based authentication with no password storage
• API Access: Complete REST API for programmatic email management

• Core service handling Lightning Network payments, email management, and user authentication
• Connects to LND for Bitcoin Lightning payments via LNDService
• Manages email accounts and SMTP sending via EmailService
• Provides RESTful API endpoints for email reading, sending, and account management

• Uses SQLite with SQLModel ORM and Alembic migrations
• Stores email accounts, access tokens, payment status, and pending outgoing emails
• Manages expiration dates for accounts and email send payments

• Manages asynchronous tasks via task queue
• Handles Lightning payment verification via check_payment_status
• Processes email account creation after successful Bitcoin payment
• Handles outgoing email delivery after Lightning payment confirmation

• Creates individual email accounts via IPC (Inter-Process Communication)
• Uses file-based requests between services with locking mechanism
• Reads emails via IMAP protocol
• Sends emails via SMTP with authentication

• Account creation and Lightning payment interface (index.html)
• Email reading and composition interface (inbox.html)
• Static assets (CSS, JavaScript) for frontend functionality

1. Create Email Account

   • POST /api/v1/email
   • Generates Bitcoin Lightning invoice
   • Returns invoice details, payment hash, and preliminary account info

2. Check Payment Status

   • GET /api/v1/payment/{payment_hash}
   • Returns Lightning payment status and account details if paid

3. List Emails

   • GET /api/v1/emails
   • Requires access token authentication
   • Returns list of email headers

4. Get Email Content

   • GET /api/v1/emails/{email_id}
   • Requires access token authentication
   • Returns email content with HTML stripped

5. Send Email

   • POST /api/v1/email/send
   • Requires access token authentication
   • Generates Lightning invoice for email sending

6. Check Send Payment Status

   • GET /api/v1/email/send/status/{payment_hash}
   • Returns status of outgoing email Lightning payment

All email access endpoints require a valid access token passed in the Authorization header:

Authorization: Bearer {access_token}

• Send & Receive: Full email functionality with Lightning payments for sending
• Web & API Access: Emails accessible through web interface and REST API
• Plain Text Focus: HTML content is stripped for security; emails are displayed as plain text
• Lightning Payments: Small Lightning payments required for each outgoing email

The EmailService class handles:

• Account creation via IPC with mail system
• Email listing and fetching via IMAP
• Email sending via SMTP with authentication
• Secure file-based inter-process communication with proper permissions handling
• Email header decoding for internationalization support

The system uses:

• Direct LND integration for Bitcoin Lightning Network payments
• Optional LNProxy integration for enhanced privacy
• Background job processing for Lightning payment verification
• Separate payment flows for account creation and email sending

1. Data Protection

   • Emails stored in individual user mailboxes
   • No long-term data retention (max 1 year)
   • No personal information required from users

2. Authentication

   • Token-based authentication with high entropy
   • No password storage for user access

3. Payment Privacy

   • Bitcoin Lightning Network payments for maximum privacy
   • No identifying payment information required

LNemail is ideal for:

• Two-factor authentication requiring fast email delivery
• Anonymous communication with Bitcoin Lightning integration
• Account verification where anonymous registration is preferred
• Newsletter subscriptions without personal data exposure
• Services requiring persistent email beyond temporary mail services
• Bitcoin/Lightning-native applications needing full email integration

# Create directories and permissions
mkdir -p dev-data/mail-data
mkdir -p dev-data/mail-state
mkdir -p dev-data/mail-logs
mkdir -p dev-data/config/ssl
mkdir -p dev-data/config
mkdir -p dev-data/mail-agent
mkdir -p dev-data/shared/requests
mkdir -p dev-data/shared/responses
mkdir -p dev-data/lnemail-data
mkdir -p dev-data/redis-data
mkdir -p docker/lnd

# Set permissions
chmod -R 777 dev-data

# Start all services
docker compose up -d

Wait a few minutes for the Bitcoin node to sync and the LND nodes to initialize. You can track the progress with:

docker logs -f ofelia
docker exec lnd lncli --network=regtest {walletbalance|channelbalance|pendingchannels|listchannels}

• Web Interface: http://localhost:8000
• API Docs: http://localhost:8000/docs
• LND REST: http://localhost:8081
• Bitcoin RPC: Available on port configured in .env

The development environment includes:

• Bitcoin regtest node with automatic mining
• Two LND nodes with channels for Lightning payments
• Mail server for email handling with SMTP support
• Redis for background job processing
• LNemail API and worker services

Use the web or API to generate an invoice, then pay it from the second LND node:

docker exec router_lnd lncli --network=regtest --rpcserver=router_lnd:10010 --tlscertpath=/shared/router_tls.cert --macaroonpath=/shared/router_admin.macaroon payinvoice --force {invoice}

Once you have an email account, you can send a test email to it:

swaks --to sereneforest630@lnemail.test \
      --from sender@lnemail.test \
      --server localhost:25 \
      --body "Test email body" \
      --header "Subject: Test Email"

You can also send emails from your LNemail account using the web interface or API.

# Stop and remove everything
docker compose down -v --remove-orphans

# Remove volumes and certificates
docker volume rm lnemail_bitcoin lnemail_lnd lnemail_router_lnd
sudo rm -f dev-data/shared/*.cert dev-data/shared/*.macaroon dev-data/shared/lnd_*

• https://emkei.cz/

This project is licensed under the MIT License. See the LICENSE file for details.

Contact: npub1rkh3y6j0a64xyv5f89mpeh8ah68a9jcmjv5mwppc9kr4w9dplg9qpuxk76