# Install offlineimap with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman

Synchronizes emails between two repositories. Version 8.0.3 via Homebrew; verified 2026-06-08.

## Install

```sh
sudo av install brew:offlineimap
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install offlineimap
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install offlineimap
```

  Evidence: MacPorts ports tree: mail/offlineimap/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add offlineimap
```

  Evidence: Alpine Linux edge package indexes: offlineimap from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install offlineimap
```

  Evidence: Debian stable package indexes: offlineimap from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install offlineimap
```

  Evidence: Fedora Rawhide package metadata: offlineimap from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#offlineimap
```

  Evidence: nixpkgs package indexes: pkgs/by-name/of/offlineimap/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S offlineimap
```

  Evidence: Arch Linux sync databases: offlineimap from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:offlineimap
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/offlineimap>
- **Version:** 8.0.3
- **Source summary:** Synchronizes emails between two repositories
- **Homepage:** <https://github.com/OfflineIMAP/offlineimap3>
- **Repository:** <https://github.com/OfflineIMAP/offlineimap3>
- **Upstream docs:** <https://github.com/OfflineIMAP/offlineimap3#readme>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://github.com/OfflineIMAP/offlineimap3/archive/refs/tags/v8.0.3.tar.gz>
- **Last updated:** 2026-06-08T10:08:26Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- offlineimap (cli)
- offlineimap (alias)

## Dependencies

- certifi
- python@3.14

## Uses from macOS

- krb5

## Install behavior

- Post-install hook: not defined
- Service: declared
- Caveats: To get started, copy one of these configurations to ~/.offlineimaprc: * minimal configuration: cp -n $HOMEBREW_PREFIX/etc/offlineimap.conf.minimal ~/.offlineimaprc * advanced configuration: cp -n $HOMEBREW_PREFIX/etc/offlineimap.conf ~/.offlineimaprc
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 8.0.3
- Package-manager updated: 2026-06-08
- Local data: ok
- Upstream repository: https://github.com/OfflineIMAP/offlineimap3
- Upstream latest detected: v8.0.3 (current)
## Project history and usage

OfflineIMAP is a long-running Python tool for synchronizing IMAP mailboxes into local Maildir trees. Its durable niche is disconnected mail: users can read, search, back up, and process mail with local Unix mail tools while OfflineIMAP handles bidirectional IMAP synchronization.

### Project history

The project predates its GitHub era; the OfflineIMAP website describes '13 years of history' for the community site, and the legacy GitHub repository was created on 2012-07-23. The mainline project reached v7.3.4 on 2021-08-03, where its changelog said the Python 2 line would receive minor bug fixes only and directed users to the Python 3 fork.

The Homebrew formula points at OfflineIMAP/offlineimap3, whose GitHub repository was created on 2020-09-02. The offlineimap3 README describes it as the Python 3 codebase based on the Python 2 OfflineIMAP project, retaining the same user-facing documentation and configuration model while the source was updated.

### Adoption history

OfflineIMAP became part of the classic console-mail stack around Maildir, Mutt, and Notmuch. The legacy repository topics include mutt, notmuch, offline, synchronize, IMAP, and Maildir, which matches how the tool is used in local-first mail workflows rather than as a standalone mail client.

Package-manager coverage is broad for a niche mail synchronizer: the input record lists packages in Homebrew, Debian, Ubuntu, Fedora/dnf, Arch/pacman, Nix, MacPorts, and Alpine. Homebrew Formulae reported version 8.0.3 and 1,359 installs in its 365-day analytics window when fetched on 2026-07-01.

### How it is used

Operators configure accounts and repositories in ~/.offlineimaprc or the XDG config path, then run the offlineimap command to synchronize remote IMAP folders with local Maildir directories. The official website frames the core use case as reading mail offline without requiring the mail user agent to support disconnected IMAP operations.

Package nerds tend to care about OfflineIMAP because it sits at the junction of old-school Unix mail storage, IMAP quirks, SSL and proxy support, and Python packaging migration. The Python 2 to Python 3 split is visible in package metadata, upstream repositories, and downstream formula maintenance.

### Why package nerds care

OfflineIMAP is a good example of a small CLI that remains relevant because it preserves a file-format contract, Maildir, rather than owning the full application experience. Its packaging history shows how downstreams track a legacy project while redirecting users to a maintained language-runtime fork.

### Timeline

- 2012-07-23: the legacy OfflineIMAP/offlineimap GitHub repository was created.
- 2015-03 and 2015-04: the v6.5.7 release candidates moved documentation to the website, added proxy support, added systemd integration files, and updated imaplib2 for work toward Python 3.
- 2020-09-02: the OfflineIMAP/offlineimap3 repository was created for the Python 3 line.
- 2021-08-03: v7.3.4 of the legacy line was described as likely the last minor release, with users directed to offlineimap3.

### Related projects

- OfflineIMAP is commonly paired with Maildir-aware or local-indexing tools such as Mutt and Notmuch. Within its own project family, offlineimap3 is the Python 3 successor to the Python 2 offlineimap repository.

### Sources

- <https://api.github.com/repos/OfflineIMAP/offlineimap>
- <https://api.github.com/repos/OfflineIMAP/offlineimap3>
- <https://formulae.brew.sh/api/formula/offlineimap.json>
- <https://formulae.brew.sh/formula/offlineimap>
- <https://github.com/OfflineIMAP/offlineimap>
- <https://github.com/OfflineIMAP/offlineimap3>
- <https://raw.githubusercontent.com/OfflineIMAP/offlineimap/master/Changelog.md>
- <https://www.offlineimap.org/>
- <https://www.offlineimap.org/documentation.html>


## Security Notes

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## 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: ~/.offlineimaprc, $XDG_CONFIG_HOME/offlineimap/config

## Credential files

- Unix: ~/.offlineimaprc, $XDG_CONFIG_HOME/offlineimap/config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** offlineimap
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - offlineimap - 7.3.3+dfsg1-1+0.0~git20240826.db34745+dfsg-2: normalized package name match | Debian stable package indexes: offlineimap from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | transitional package | https://github.com/OfflineIMAP/offlineimap3
- Nix - offlineimap: normalized package name match | nixpkgs package indexes: pkgs/by-name/of/offlineimap/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - offlineimap - 7.3.3+dfsg1-1+0.0~git20231218.d29a4dc+dfsg-3ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: offlineimap from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | transitional package | https://github.com/OfflineIMAP/offlineimap3
- apk - offlineimap - 8.0.0-r4: normalized package name match | Alpine Linux edge package indexes: offlineimap from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Read/sync your IMAP mailboxes | https://github.com/OfflineIMAP/offlineimap3
- apk - offlineimap-pyc - 8.0.0-r4: normalized package name match | Alpine Linux edge package indexes: offlineimap-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for offlineimap | https://github.com/OfflineIMAP/offlineimap3
- dnf - offlineimap - 8.0.2-2.fc45: normalized package name match | Fedora Rawhide package metadata: offlineimap from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Powerful IMAP/Maildir synchronization and reader support | https://www.offlineimap.org/
- pacman - offlineimap - 8.0.2-1: normalized package name match | Arch Linux sync databases: offlineimap from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Synchronizes emails between two repositories | http://offlineimap.org/
- MacPorts - offlineimap: normalized package name match | MacPorts ports tree: mail/offlineimap/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [mailcheck](https://www.automicvault.com/pkg/brew/mailcheck/) - Shares av.db curated category or tags: cli, email, imap, maildir, productivity.
- [meli](https://www.automicvault.com/pkg/brew/meli/) - Shares av.db curated category or tags: cli, email, imap, maildir, productivity.
- [neverest](https://www.automicvault.com/pkg/brew/neverest/) - Shares av.db curated category or tags: cli, email, imap, productivity, sync.
- [himalaya](https://www.automicvault.com/pkg/brew/himalaya/) - Shares av.db curated category or tags: cli, email, imap, productivity.
- [mail-deduplicate](https://www.automicvault.com/pkg/brew/mail-deduplicate/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [mairix](https://www.automicvault.com/pkg/brew/mairix/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [mu](https://www.automicvault.com/pkg/brew/mu/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [neomutt](https://www.automicvault.com/pkg/brew/neomutt/) - Shares av.db curated category or tags: cli, email, imap, productivity.
- [alot](https://www.automicvault.com/pkg/brew/alot/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, email, productivity, python, python-3-14.
- [gyb](https://www.automicvault.com/pkg/brew/gyb/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, email, productivity, python.
- [urlscan](https://www.automicvault.com/pkg/brew/urlscan/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, email, productivity, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/offlineimap.yml](https://github.com/automic-vault/db/blob/main/combined/offlineimap.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
