A simple, self-hostable relay server that acts as a dumb encrypted mailbox. Any application can use it to pass encrypted data between users. The server never sees plaintext — all encryption/decryption happens client-side.

• Encrypted Message Relay: Store and retrieve opaque encrypted payloads via simple REST endpoints
• Self-Hostable: Single binary, embedded SQLite, zero external dependencies
• Configurable TTL: Auto-purge messages after N days, or set to 0 for permanent storage
• Rate Limiting: Built-in IP-based rate limiting to prevent abuse
• API Key Auth: Optional API key authentication for private relays
• Docker Ready: Dockerfile and Docker Compose included

• Go 1.22+
• SQLite (embedded, WAL mode) via mattn/go-sqlite3
• net/http (standard library)

• Docker + Docker Compose
• GitHub Actions CI/CD

graph TD
    Client["Client / SDK"] -->|HTTP| MW1["API Key Middleware"]
    MW1 --> MW2["Rate Limiter"]
    MW2 --> Mux["net/http ServeMux"]
    Mux -->|"POST /api/messages"| H1["Create Message"]
    Mux -->|"GET /api/messages/:address"| H2["Get by Address"]
    Mux -->|"DELETE /api/messages/:id"| H3["Delete Message"]
    Mux -->|"GET /health"| H4["Health Check"]
    H1 & H2 & H3 --> Store["Store Interface"]
    Store --> SQLite["SQLiteStore (WAL mode)"]
    BG["Hourly Purge Goroutine"] --> Store

curl -X POST http://localhost:3000/api/messages \
  -H "Content-Type: application/json" \
  -d '{"to": "0xRecipient", "from": "0xSender", "payload": "encrypted_base64_data"}'

curl http://localhost:3000/api/messages/0xRecipient

curl -X DELETE http://localhost:3000/api/messages/<message-id>

1. ThruBox Server — This repository (relay server)
2. ThruBox Client — TypeScript SDK

• Go 1.22+ with CGo enabled (required for SQLite)
• GCC (for compiling go-sqlite3)
• Docker (optional, for containerized deployment)

git clone https://github.com/AOSSIE-Org/ThruBox-Server.git
cd ThruBox-Server

go mod download

go build -o relay-server ./cmd/relay
./relay-server

The server starts on http://localhost:3000 with a SQLite database that auto-creates at ./data/relay.db.

docker compose up -d

Edit config.yaml or use environment variables:

⭐ Don't forget to star this repository if you find it useful! ⭐

Thank you for considering contributing to this project! Contributions are highly appreciated and welcomed. To ensure smooth collaboration, please refer to our Contribution Guidelines.

• Bruno
• Atharva

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Thanks a lot for spending your time helping ThruBox grow. Keep rocking 🥂

© 2025 AOSSIE