Pegasus Bridge — Send Email Through Pegasus Mail

Pegasus Bridge runs in the background while you are signed in to Windows. It must run under the same Windows user and in the same interactive session as Pegasus Mail.

A local application submits the sender address, recipients, subject and text over an authenticated local HTTP API. Pegasus Bridge validates the data and passes the message to Pegasus Mail through its DDE interface. It is not an SMTP server and does not replace Pegasus Mail.

• An authenticated bridge for applications on the same computer
• Ready-to-use Windows PowerShell, PHP, XAMPP and WSL2 clients
• Automatic startup when you sign in to Windows
• Optional WSL2 and XAMPP integration
• English and Bulgarian local documentation
• A support-bundle tool that excludes the access token and message content

Message data

Each message contains a sender address, one or more recipients, a subject and plain-text content. An optional Reply-To address can be supplied; otherwise the sender address is used as Reply-To.

Version 1.0.3 does not support HTML, attachments, CC/BCC, custom headers or selecting a Pegasus Mail identity from the calling application.

The diagram shows how the Windows PowerShell, PHP/XAMPP and WSL2 clients connect to the authenticated local API, how Pegasus Bridge validates the request and how the message is submitted to Pegasus Mail.

• 64-bit Windows 10 or Windows 11
• Pegasus Mail for Windows
• Administrator rights during installation
• Pegasus Mail and Pegasus Bridge running as the same signed-in Windows user
• WSL2 only when applications inside WSL2 need access
• XAMPP only when local PHP applications use XAMPP

1. Download the installer only from the official page or the address supplied after purchase.
2. Compare its SHA-256 checksum with the published value. Version 1.0.3 is unsigned, so Windows may display a warning.
3. Run the installer with administrator rights.
4. Confirm the main Pegasus Mail directory. It must contain Programswinpm-32.exe.
5. Keep Loopback only for ordinary Windows use. Select WSL2 or XAMPP only if required.
6. Finish installation, start Pegasus Mail and select the sender identity you want to use.
7. Run the health check to confirm that the connection is ready.

Installation creates a random Bearer access token. It is stored only on the computer and authenticates requests to Pegasus Bridge. Repair and upgrade preserve the existing configuration and token.

Before sending, start Pegasus Mail, select the identity that should be the actual sender, and make sure Pegasus Bridge is running in the same Windows user session.

1. Check the connection

Invoke-RestMethod http://127.0.0.1:18765/v1/health

A ready response contains "ok": true and "status": "ready". pegasus_unavailable usually means Pegasus Mail is not running or is in a different Windows session.

2. Send from Windows PowerShell

& 'C:PMAILPegasus Bridgeclientssend.ps1' `
  -From 'sender@example.com' `
  -To 'recipient@example.com' `
  -Subject 'Test' `
  -Text 'Hello!' `
  -ReplyTo 'replies@example.com'

Change the path if you installed the product elsewhere. -ReplyTo is optional and defaults to -From.

3. Send from PHP / XAMPP

require 'C:PMAILPegasus Bridgeclientssend.php';
$result = pegasus_bridge_send(
    'sender@example.com',
    ['recipient@example.com'],
    'Test',
    'Hello!',
    'replies@example.com'
);

Select the XAMPP component during installation or Modify when Apache/PHP runs as LocalSystem. The installer exposes a protected path to the Bearer access-token file through PEGASUS_BRIDGE_TOKEN_FILE. By default it is stored at C:\PMAIL\Pegasus Bridge\runtime\token.txt. Treat it as a password; never copy it into PHP or WordPress code, a database, the web root, a page, log or exception.

4. Send from WSL2

export PEGASUS_BRIDGE_TOKEN='your-token-value'
'/mnt/c/PMAIL/Pegasus Bridge/clients/send-wsl.sh' 
  'sender@example.com' 
  'recipient@example.com' 
  'Test' 
  'Hello!' 
  'replies@example.com'
unset PEGASUS_BRIDGE_TOKEN

The WSL2 component must be enabled during installation or Modify. The client discovers the Windows gateway through ip route show default. Do not store the token in source code, shell history or a publicly readable environment file.

Fields and response

• from, to, subject and text are required.
• replyTo is optional and defaults to from.
• from does not change the actual MIME From; the active Pegasus Mail identity determines it.
• HTTP 202 accepted_by_pegasus means Pegasus Mail accepted the operation, not that delivery is complete.

• The bridge is intended only for applications on the same computer.
• Every send request requires the Bearer token generated during installation.
• WSL2 access is limited to the necessary private virtual network.
• XAMPP receives permission to read only the access-token file.
• Addresses and the subject are validated before acceptance.
• Logs exclude recipients, subject, message text and access token.
• Support bundles exclude the token, messages and Pegasus Mail mailbox.

Update

Run the newer installer over the existing version. Your configuration and access token are preserved.

Uninstall

Use Windows Settings → Apps → Installed apps → Pegasus Bridge → Uninstall. You can choose whether to retain runtime settings for a future installation. Full removal deletes the files and firewall rules created by Pegasus Bridge.

Version 1.0.3 has been tested with Windows, WSL2 and XAMPP, including clean installation, upgrade, uninstall and submission of Unicode messages.

A successful submission means Pegasus Mail accepted the operation. Delivery depends on Pegasus Mail, your mail provider and the recipient's server.

License

• One purchase licenses one user on one Windows computer.
• Personal and business use are allowed.
• You may move the product to a new computer after discontinuing use on the old one.
• Separate purchases are required for additional users or computers.
• The installer may not be published, resold or supplied to other people.

No online activation or tracking

The product does not verify your purchase online, bind itself to hardware or track usage.

14-day money-back guarantee

You may request a full refund within 14 calendar days of the purchase date by emailing PegasusBridge@krumch.com and including your order email or order reference.

We strongly encourage you to tell us what did not meet your needs. Your reason helps us improve the product or offer a solution, but it is optional and will not delay or prevent the refund.

We will initiate the refund within 5 business days. The time needed for the funds to appear in your account depends on the payment provider and your bank. After the refund, the license terminates and you must uninstall Pegasus Bridge and delete any saved copies of the installer.

The voluntary guarantee may be refused in cases of proven fraud, repeated refund abuse, sharing or resale of the product, or a chargeback filed after the payment has already been refunded. This does not limit any mandatory rights you have under applicable law.

Updates and support

The purchase includes 12 months of updates and email support. The version you received continues to work after that period.

Support: PegasusBridge@krumch.com. Never send the access token.

Is this a standalone mail server?

No. Pegasus Bridge submits messages to a running, configured Pegasus Mail client.

Can the application select the sender identity?

No. The active identity in Pegasus Mail determines the actual sender.

Are HTML and attachments supported?

No. Version 1.0.3 supports plain text only and no attachments.

Can it run without a signed-in user?

No. Pegasus Bridge and Pegasus Mail must run in the same interactive Windows user session.

What does “accepted” mean?

Pegasus Mail accepted the validated operation for sending. This is not proof of delivery.

Is online activation required?

No. There is no activation server or usage tracking.

How do I request a refund?

Email PegasusBridge@krumch.com within 14 calendar days of purchase and include your order email or reference. A reason is strongly encouraged but optional.