Skip to main content
Prism MigrationPrism Migration
Maildir Converter

Convert cPanel & Dovecot Maildir to Outlook PST (2026)

P
Prism Migration Team Author
8 min read · Published August 16, 2026
Executive Summary & Key Takeaway

Migrating from a Linux cPanel server to Microsoft Outlook? Learn how to parse Maildir /cur, /new, and /tmp directories and convert them to 64-bit Unicode PST.

On This Page (7 sections) ▾
✦Tip

⚡ Quick Direct Answer: Converting cPanel Maildir to Outlook PST

Linux email servers running cPanel, Dovecot, and Postfix store messages in Maildir format (extensionless files in cur/, new/, and tmp/ directories). Windows Outlook cannot read these files natively.

  1. Extract cPanel Backup: Download and uncompress the mail/ directory from your cPanel backup archive.
  2. Convert to Unicode PST: Use Prism Maildir Converter Tool to parse the cur/ and new/ directories, convert Linux status flags (:2,S, :2,R), and build a 64-bit Unicode .pst file.
  3. Open in Windows Outlook: Open Outlook Classic and select File > Open & Export > Open Outlook Data File (.pst) to mount your folder tree.

Migrating an organization from Linux-based email hosting to Microsoft 365 or desktop Outlook involves significant file format differences.

Web hosting platforms like cPanel, WHM, Postfix, and Dovecot store individual messages as raw text files on the server file system. Microsoft Outlook does not read these files directly.

Linux servers rely on Maildir setups—where every draft, read message, and delivery notice is saved as its own isolated, extensionless text file.

Inside these directories, you will find three specialized subfolders: cur/ (read messages), new/ (unread mail), and tmp/ (messages in transit). Maildir filenames consist of unique system timestamps, process identifiers, and delivery flags (such as 1723719283.M918272P1204.server.domain.com:2,S).

Downloading a raw cPanel backup provides a directory tree of loose, extensionless files that Windows and Outlook cannot mount directly.

This guide explains how to convert Linux cPanel and Dovecot Maildir folders into clean, importable Outlook PST archives, examining Maildir structure, live IMAP synchronization limits, and offline batch conversion workflows.


Anatomy of a Linux Maildir Folder

Renaming file extensions individually is ineffective due to the metadata embedded in Maildir filenames. A standard Dovecot or cPanel Maildir structure organizes data as follows:

CODE / SCRIPTCode / Script
┌────────────────────────────────────────────────────────┐
│  LINUX CPANEL / DOVECOT MAILDIR ARCHITECTURE           │
├────────────────────────────────────────────────────────┤
│  /home/user/mail/domain.com/john/                      │
│    ├── maildirsize               (Disk quota cache)    │
│    ├── dovecot.index             (Server index cache)  │
│    ├── cur/                      (Read / Synced Mail)  │
│    │     └── 1709123841.M120P8.host:2,S (Seen email)   │
│    │     └── 1709123902.M415P9.host:2,RS (Replied)     │
│    ├── new/                      (Unread Messages)     │
│    │     └── 1709124011.M882P2.host:2, (Unread email)  │
│    ├── tmp/                      (In-Flight Spool)     │
│    └── .Sent/                    (Subfolder: Sent)     │
│          ├── cur/                                      │
│          └── new/                                      │
└────────────────────────────────────────────────────────┘

Two major technical hurdles exist when accessing Maildir files on Windows:

  1. Extensionless Files: Windows and Outlook do not automatically recognize extensionless UNIX text files as mail items.
  2. Maildir Flag Encoding: Read, replied, flagged, and draft statuses are encoded in the filename trailing the :2, delimiter (e.g., S indicates Seen, R indicates Replied, F indicates Flagged).

The Automated Route: Conversion via Prism Engine

Migrating user mailboxes from an offline cPanel backup requires a dedicated Maildir parser. The Prism Maildir Converter Tool processes these directory structures, translates Linux flags into MAPI properties, and outputs a 64-bit Unicode .pst file.

✦Tip

Key Capabilities of Maildir to PST Conversion:

  • Auto-Detects Subfolder Trees: Custom folders such as .Sent, .Drafts, .Trash, and .Junk are parsed into standard Outlook folders.
  • Translates Maildir Flag Metadata: Linux :2,S (Seen) and :2,R (Replied) codes convert directly into native Microsoft MAPI indicators.
  • Standalone Execution: Generates clean Outlook PST databases on Windows or macOS without requiring an active Outlook installation.
  • Multi-Format Output Support: Exports data directly to PST, MBOX, PDF, EML, MSG, and HTML.
  • Parallel Processing: Converts multi-gigabyte cPanel tarballs and multiple user directories simultaneously.

Running the Conversion:

  1. Launch Prism Maildir Converter Tool on your workstation.
  2. Select Add Maildir Folder and select your uncompressed cPanel mail/ directory.
  3. The engine scans all cur/, new/, and hidden dot-prefixed folders, displaying an interactive preview of messages, headers, and attachments.
  4. Choose PST (Outlook Unicode) from the export options list.
  5. In Advanced Settings, configure:
  • Check Maintain Linux Maildir Folder Hierarchy to preserve folder structures.
  • Set an optional Auto-Split Threshold (e.g., 10 GB or 20 GB) to keep PST archives within manageable size limits.
  • Apply optional Date Range Filters to migrate specific periods.
  1. Click Convert Now to stream messages directly into an Outlook-compatible PST file.
ℹNote

Free Trial Evaluation: The demo version converts up to 50 items per folder, allowing administrators to verify folder tree recreation, read/unread flag preservation, and attachment extraction before licensing.


The Manual Path: Live IMAP Synchronization

When the source mail server remains active and accessible online, you can transfer messages using live IMAP synchronization:

Step-by-Step Instructions:

  1. Add the cPanel mail account to Microsoft Outlook as a standard IMAP account.
  2. Wait for Outlook to sync the entire server folder tree down to a local .ost cache file.
  3. Select File > Open & Export > Import/Export in the Outlook menu.
  4. Pick Export to a file > Outlook Data File (.pst).
  5. Target the root IMAP folder and export the contents to an offline .pst archive.
⚠Warning

Limitations of Live IMAP Synchronization:

  • Bandwidth Throttling: Synchronizing large mailboxes over IMAP can saturate network bandwidth and trigger web hosting connection limits or temporary IP bans.
  • Decommissioned Servers: If hosting accounts are terminated or servers are offline, live IMAP synchronization is impossible.
  • Timeout Interruptions: Large mailboxes with tens of thousands of items frequently encounter socket timeouts during extended IMAP transfer sessions.

Technical Comparison: Maildir Migration Workflows

Capability / MetricManual Shell ScriptingLive IMAP SyncPrism Migration Engine
Works with Offline Backups⚠️ Partial (.eml only)❌ Not Supported🛡️ Full Offline Processing
Preserves Linux Read/Replied Flags❌ Stripped⚠️ Inconsistent✅ MAPI Flag Translation
Preserves Subfolder Tree❌ Flattened⚠️ Partial✅ Exact Folder Hierarchy
Output to 64-bit Unicode PST❌ No⚠️ Requires Outlook✅ Native Standalone Generation
Migration Speed (50 GB Mailbox)⏱️ Several Hours⏳ Bandwidth Dependent⚡ High-Speed Local I/O

Shell Scripting vs. Binary Parsers: Why Bash Rename Loops Break Maildir Data

Administrators sometimes attempt to append .eml extensions to raw files in cur/ and new/ directories using shell loops:

CODE / SCRIPTBash
# Script that can introduce metadata and attachment issues
for file in /home/user/mail/domain.com/john/cur/*; do
    mv "$file" "$file.eml"
done

While this allows Windows File Explorer to recognize individual files, importing them into Outlook introduces significant problems:

  1. Stripped Read and Replied Status: The Maildir specification stores state flags in the file suffix after :2, (such as :2,S for Seen, :2,R for Replied, :2,F for Flagged). Renaming or dragging these files discards the trailing flag string, resetting every read message back to unread status.
  2. Unix LF vs. Windows CRLF Incompatibilities: Linux MTAs store raw MIME messages using bare Line Feed (\n) characters. Microsoft Outlook's MAPI parser expects standard Internet CRLF (\r\n) line breaks. When Outlook opens bare LF messages, multi-part MIME boundaries can fail to separate cleanly, corrupting attachment decoding.
  3. Maildir++ Directory Dot Flattening: Dovecot uses the Maildir++ convention where folders appear as .INBOX.Accounting.Invoices. Simply copying these directories into Windows collapses nested subtrees into flat, detached root folders.

Deploying a binary Maildir-to-PST engine parses the :2, flag string directly into Microsoft MAPI status bits, normalizes all LF line endings to RFC-compliant CRLF, and automatically reconstructs the full nested folder hierarchy inside a native 64-bit Unicode PST.


Frequently Asked Questions (FAQs)

Q1. What Linux email servers use the Maildir format?

Ans: Most standard Unix mail platforms default to Maildir, including cPanel / WHM, Postfix, Dovecot, Exim, Qmail, Courier, and Plesk Panel.

Q2. How does Prism Migration handle dot-prefixed Maildir folders (like .Sent or .Drafts)?

Ans: Linux prepends subfolders with a dot, such as .INBOX.Sent. The Prism Maildir Converter Tool strips these periods and reconstructs clean, human-readable directory structures like Sent Items or Drafts inside your output PST.

Q3. Can I convert Maildir files directly to MBOX or PDF format?

Ans: Yes. Choose MBOX (for Thunderbird) or PDF (for compliance and legal archiving) directly from the format options dropdown.

Q4. What happens to files inside the /tmp Maildir folder?

Ans: The tmp/ folder contains messages that were being written when the backup occurred. The engine scans these, validates the MIME headers, and extracts valid, readable messages.

Q5. Can I migrate cPanel Maildir files directly to Office 365 / Microsoft 365?

Ans: Yes. You can authenticate via administrator credentials or OAuth to migrate converted Maildir messages directly to Microsoft 365 cloud mailboxes.


The Bottom Line

Migrating from cPanel to Outlook is most reliably accomplished by working with offline backups rather than relying on live IMAP connections or fragile shell scripts. Because Maildir files contain raw RFC 822 MIME payloads, parsing them directly into a 64-bit Unicode PST preserves message integrity, folder hierarchy, and read/replied flags.

Using the Prism Maildir Converter Tool automates this process, providing an efficient path to transition Linux email archives to Microsoft Outlook.

Related Guides:

Recommended Automated Utility Windows 11 & 10 (32 & 64-bit) & macOS

Maildir Converter Tool (2026 Enterprise Edition)

Convert Linux and cPanel Maildir folders to multiple formats including PST, PDF, MBOX, EML, and Microsoft 365. Fast 64-bit standalone converter with full folder organization. Runs natively on Windows 11 and Apple Silicon M1–M4 Mac.

Windows 11 & 10 (32 & 64-bit) & macOS 1, 2 & 3-Year License Options Free Trial (50 items/folder)