Ruby 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).

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 useable 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.


  • Prerequisite: You need a ruby install (apt-get install ruby)
  • Save the script (scroll down) to your machine (MaildirToImap.rb)
  • Edit the script ans set the variables IMAP_HOST, IMAP_USER, and IMAP_PASS to correct values.
  • Use the script with 2 params(absolute directory of a Maildir Inbox, IMAP box name), see examples:

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.


# 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 dir\n"

imap =
imap.authenticate('LOGIN', IMAP_USER, IMAP_PASS)
        print "Failed creating: ", imap_dir, ", that's probably OK\n"
upload_dir(imap, mail_dir, imap_dir)


Add a new Comment