Get Started

Inbound

Set up and run the Reloop inbound MX receiver locally in Docker.

Complete Base Setup First

Ensure you've finished the Setup and have Docker Desktop running.

Service Overview

Inbound KumoMTA MX receiver — accepts external mail, scans with RSpamD, forwards to inbox via NATS.

PropertyValue
Directoryapps/backend/inbound
Docker serviceinbound (container reloop-inbound)
SMTP port25
HTTP port8030 (health check)
StackKumoMTA Lua RSpamD

Quick Start

Starts with the full Docker stack:

bun docker:up

Or start only inbound from local/:

cd local && docker compose up -d inbound

Configuration

Key variables in local/docker-compose.yml:

VariableDefault
INBOUND_HOSTNAMEinbound.reloop.sh
NATS_URLreloop-nats:4222
KUMOMTA_RSPAMD_URLhttp://reloop-rspamd:11333/checkv2
KUMOMTA_CHECK_RECIPIENT_URLhttp://host.docker.internal:8011/api/domain

Container Commands

CommandDescription
docker compose up -d inboundStart inbound container
docker logs -f reloop-inboundStream logs
curl http://localhost:8030/healthHealth check

Architecture

External Sender → Port 25 → Recipient Check → RSpamD → NATS → Inbox
LayerDetail
MX receptionAccepts inbound mail on port 25.
Validationdomain service verifies recipients.
ForwardingAccepted messages published to NATS for inbox.
OutboundSubmission is handled by smtp, not this service.

Was this page helpful?

Edit this page
PreviousSMTPNextOverview