README

Laravel mail transport for DashaMail — the leading Russian transactional and marketing email platform.

Built by Nomadicsoft.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12

Installation

composer require nomadicsoft/laravel-dashamail

The service provider is auto-discovered — no manual registration needed.

Prerequisites

Before sending, DashaMail requires:

1. Configured sending domain — add your domain with SPF & DKIM records at
   DashaMail dashboard → Аккаунт → Мои домены

2. Confirmed from-address — verify your sending address at
   Доставляемость → Подтверждённые отправители

3. API access enabled — on the free plan, email support@dashamail.ru to enable the transactional API. On paid plans it is available immediately.

4. API key — find it at Интеграции → Транзакционные письма

Configuration

1. Add your API key to .env

DASHAMAIL_API_KEY=your_api_key_here
MAIL_MAILER=dashamail
MAIL_FROM_ADDRESS=noreply@yourdomain.ru
MAIL_FROM_NAME="Your App"

2. Add the mailer to config/mail.php

'mailers' => [

    'dashamail' => [
        'transport' => 'dashamail',
        'api_key'   => env('DASHAMAIL_API_KEY'),
    ],

    // ... other mailers
],

3. Set as default mailer

MAIL_MAILER=dashamail

Or use it explicitly per-send:

Mail::mailer('dashamail')->to($user)->send(new WelcomeMail());

Usage

Works with all standard Laravel mail features:

// Notifications
$user->notify(new ResetPasswordNotification($token));

// Mailables
Mail::to('user@example.com')->send(new InvoiceMail($invoice));

// Fluent
Mail::mailer('dashamail')
    ->to('user@example.com')
    ->cc('manager@example.com')
    ->send(new OrderConfirmationMail($order));

What's supported

Changelog

1.0.0

• Initial release

License

MIT. See LICENSE.

About Nomadicsoft

Nomadicsoft is a software development company. We build web applications, APIs, and internal tools.