Skip to main content Logo

Quis custodiet ipsos custodes?
Home | About | All pages | Cluster Status | 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

❗ This post is over nine years old. It may no longer be up to date. Opinions may have changed.

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

I'm developing a desktop monitoring app, Leaf Node Monitoring, open source, but paid. For Windows, Linux & Android, go check it out.

Consider sponsoring me on Github. It means the world to me if you show your appreciation and you'll help pay the server costs.

You can also sponsor me by getting a Digital Ocean VPS. With this referral link you'll get $100 credit for 60 days.

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