# Install imap-backup with Homebrew Backup GMail (or other IMAP) accounts to disk. Version 16.6.0 via Homebrew; verified 2026-06-06. ## Install ```sh sudo av install brew:imap-backup ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install imap-backup ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:imap-backup - **Package manager:** Homebrew - **Version:** 16.6.0 - **Source summary:** Backup GMail (or other IMAP) accounts to disk - **Homepage:** - **Repository:** - **Last updated:** 2026-06-06T17:04:39Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - imap-backup (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 16.6.0 ## Project history and usage imap-backup is a Ruby command-line tool for backing up and migrating IMAP email accounts to local disk. It targets Gmail and other IMAP services, storing messages in mboxrd files with companion metadata. ### Project history The RubyGems version history shows `imap-backup` beginning with 0.0.1 in 2012 and reaching 1.0.0 in early 2013. The project's developer documentation states design goals of secure local configuration, restartable operation, and independence from a mail client or MTA. The tool has grown from basic account backup into a broader IMAP maintenance utility. Recent changelog entries document download strategies, Thunderbird export improvements, configuration-free single-account backups, container images, a consolidated `copy` command replacing older migration and mirror flows, account locking, metadata migrations, and internationalization. ### Adoption history imap-backup is distributed as a RubyGem and as a Homebrew formula. RubyGems download counts are much higher than Homebrew installs, which fits a Ruby CLI whose main package channel is the gem ecosystem, while Homebrew gives Mac and Linux users a convenient binary-package entry point. The package's adoption comes from a durable personal-infrastructure problem: IMAP accounts need local, restartable, scriptable backups without coupling the archive to a desktop mail client. Its docs also cover migration and restore operations, so the tool is used for both preservation and moving mail between providers. ### How it is used `imap-backup setup` creates configuration, and `imap-backup backup` copies messages for configured accounts to disk. The backup command is incremental and interruptible, and stores email in mboxrd files with IMAP metadata containing offsets and message lengths. The config documentation records the default path as `~/.imap-backup/config.json` and warns that usernames and passwords are stored in plain text there, with permissions set on Unix-like systems. Other commands include restore, copy, and single-account backup flows, with performance settings for delayed metadata writes and multi-fetch size. ### Why package nerds care imap-backup is package-nerd significant because it turns email portability into a boring CLI workflow. It also demonstrates the tradeoffs of local-first backup tools: plain JSON configuration, mboxrd serialization, metadata version migrations, locking, and careful restart behavior matter more than a large service backend. ### Timeline - 2012: imap-backup 0.0.1 was published to RubyGems. - 2013: imap-backup 1.0.0 was published to RubyGems. - 2022: The changelog records backup flags, mirror mode, stats, and provider-specific backup fixes in the 6.x and 7.x lines. - 2023: Version 14.0.0 added configuration-free single-account backups, and 14.3.0 added container images. - 2024: Version 16.0.0 added the `copy` command and deprecated older migrate/mirror commands. - 2026: The 16.x and 17.0.0.rc0 lines added localization, account locking, metadata migration, and mboxrd serialization fixes. ### Related projects - imap-backup is related to IMAP synchronization and archival tools such as isync/mbsync and offline mail workflows, but its docs emphasize local mboxrd backups plus restore/copy operations rather than maintaining a live Maildir mirror. ### Sources - - - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.imap-backup/config.json ## Credential files - Unix: ~/.imap-backup/config.json ## Combined YAML source View the package source record on GitHub. [combined/imap-backup.yml](https://github.com/mxcl/pkgdb/blob/main/combined/imap-backup.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph