Skip to main content Logo (IEC resistor symbol) logo

Quis custodiet ipsos custodes?
Home | About | All pages | RSS Feed | Gopher

Ruby script to upload or convert a Maildir Inbox to an IMAP server

Published: 01-01-2013 | Author: Thibaut Colar | Text only version of this article

Table of Contents

Note: The original page is often offline, so therefore the script is mirrored here. Credits to the original author: script to upload convert a maildir inbox to an imap_server

I decided to change email server for several reasons, anyway, long story short I was using postfix(qmail before that) and decided to switch to citadel, which is much easier to deal with (simple config).

If you like this article, consider sponsoring me by trying out a Digital Ocean VPS. With this link you'll get $100 credit for 60 days). (referral link)

Anyway, Citadel use it's own format for emails (Berkeley DB), so you can't just copy over the existing emails stored in Maildir format (8 years worth !), but since Citadel provides an IMAP server, all I need is a tool that can copy/upload The IMAP folder(s) content to an IMAP server.

I thought that would already exist, easy to find, but did not seem to find one. I found one made in PERL, but as usual Perl / CPAN failed me completely :(

I found another one that was really bare bone but usable here:

It's quite compact and easy to use, tanks to ruby, but it was kinda hard coded to copy just the Inbox folder ... in my case I had many subfolders (Sent, archives and so on) that I wanted to copy as well, so I modified it a little to make it "parameterizable", so i could run it against other sub folders of my choice.


Example: Copy the Inbox

ruby MaildirToImap.rb /home/tcolar/Maildir/cur/ INBOX

Example: Copy an Inbox sub-folder (ex: 'Sent')

ruby MaildirToImap.rb /home/tcolar/Maildir/.Sent/cur/ INBOX/Sent

Repeat for all the sub-folders you want to copy.

It takes about 0.5 seconds per email (on a local server), so if you have many emails it can take a while.

The script:

# Thibaut Colar
# "Upload" a local Maildir folder onto an IMAP server
# Inspired by:
# WARNING: Come with no warranties of any kind whatsoever, use at your own risk !
# Use, Example: ruby MaildirToImap.rb /home/tcolar/Maildir/cur INBOX
# Example(sub-box): ruby MaildirToImap.rb /home/tcolar/Maildir/.Sent/cur/ INBOX/Sent

#vars - set accordingly
IMAP_HOST = 'localhost'
IMAP_USER = 'me'
IMAP_PASS = 'my_password'
TEST_MODE = 0 # Set to 0 to actually do it

# program
require 'net/imap'

def upload_dir(imap, mail_dir, imap_dir)
        msgs = Dir.entries(mail_dir).each do |f|
        if ! then
                print "Will add ", mail_dir, f, "t to: ", imap_dir, "n"
                if TEST_MODE == 0 then

# Main
if ARGV.length < 2 then
        print "Expecting 2 params: - maildir directory (usually ends with /cur) - IMAP dirn"

imap =
imap.authenticate('LOGIN', IMAP_USER, IMAP_PASS)
        print "Failed creating: ", imap_dir, ", that's probably OKn"
upload_dir(imap, mail_dir, imap_dir)
Tags: email , imap , nopriv , ruby , software