mail-worker/README.md

AyrisTech Mail Worker (V10.3)

Mailcow Dovecot loglarını ve dosya sistemini izleyerek yeni gelen mailleri Next.js webhook'una ileten servis.

Kurulum

1. Dosyaları Hazırlayın

Proje dizinine gidin ve .env dosyasını düzenleyin:

NEXTJS_WEBHOOK_URL=https://sizin-siteniz.com/api/webhooks/mail-signal
WEBHOOK_SECRET=buraya_guclu_bir_sifre_yazin

2. Yerel Çalıştırma

Node.js (v18+) yüklü olduğundan emin olun:

npm install
npm start

3. Docker ile Çalıştırma

En güvenli ve kolay yöntem Docker konteyneri olarak çalıştırmaktır:

# Resmi oluşturun
docker build -t ayristech-worker .

# Konteyneri başlatın
docker run -d \
  --name ayristech-worker \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/:/var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/ \
  --env-file .env \
  --restart unless-stopped \
  ayristech-worker

Önemli Notlar

• Docker Socket: Servis docker exec komutu kullandığı için /var/run/docker.sock mount edilmelidir.
• Vmail Volümü: Mailcow'un mail dosyalarını sakladığı volüm /var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/ yoluna mount edilmelidir.

---

AyrisTech Mail Worker (V10.3) - English

Service that monitors Mailcow Dovecot logs and filesystem to forward new incoming emails to a Next.js webhook.

Installation

1. Prepare Files

Go to the project directory and edit the .env file (refer to .env.example):

NEXTJS_WEBHOOK_URL=https://your-domain.com/api/webhooks/mail-signal
WEBHOOK_SECRET=your_strong_secret_here

2. Run Locally

Ensure Node.js (v18+) is installed:

npm install
npm start

3. Run with Docker

The most secure and easy method is to run as a Docker container:

# Build the image
docker build -t ayristech-worker .

# Start the container
docker run -d \
  --name ayristech-worker \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/:/var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/ \
  --env-file .env \
  --restart unless-stopped \
  ayristech-worker

Important Notes

• Docker Socket: The service uses the docker exec command, so /var/run/docker.sock must be mounted.
• Vmail Volume: The volume where Mailcow stores email files must be mounted to the path /var/lib/docker/volumes/mailcowdockerized_vmail-vol-1/_data/.