IMessage Archive

Self-hosted iMessage archive that backs up a trusted, unlocked iPhone with libimobiledevice and provides indexed search, conversation browsing, and HTML,…

  • Backup
  • Tools & Utilities
Self-hosted iMessage archive that backs up a trusted, unlocked iPhone with libimobiledevice and provides indexed search, conversation browsing, and HTML, text, CSV, ZIP, and resumable PDF exports for homelab users.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

43/100 Fair

Maintained
71last commit 47 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
1
Open issues
11
Last commit
2026-10-05
Latest release
v4.0.1
License
GPL-3.0
Activity
rising

Checked 23 days ago - source: GitHub (crywolf203/imessage-archive)

Resources & Compatibility

Requirements not published yet.

Checked 46 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Find the iMessage database file The app looks for the iMessage database (the file that stores your iMessage messages) in a default path. If it points to the wrong file or no file, it won’t show messages or attachments, so verify the correct database location before debugging anything else. source
  • Linux amd64 and USB pairing Requires a Linux amd64 host. The iPhone must be USB-paired before backup, and scheduled Wi-Fi backup requires an already paired, network-visible device. source
  • Privileged USB hotplug warning Privileged mode grants broad host access for USB hotplug, so install only on a trusted private server. source
  • Administrator credentials and encryption Set a unique administrator password and session secret before use. Encrypted backups are supported, but generated exports are not encrypted. source

Fetched 44 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Why does the backup need my iPhone to be unlocked and trusted?

The iPhone must be unlocked and trusted before a backup can start. A first backup can take hours, and later backups are incremental unless Force full backup is selected.

What credentials do I need to set before using it?

Choose a username, set a unique administrator password, generate a session secret once, and check the storage paths. Leave performance settings and scheduling off until a manual backup and export work.

Are my exported messages encrypted if I use an encrypted iPhone backup?

Encrypted local backups include more protected iPhone data, but HTML, text, CSV, ZIP, and PDF outputs are not encrypted. Keep the export shares private.

How much free space do I need on the cache share?

The cache must have room for the first full iPhone backup. Large exports can use an array-backed share.

Can it back up over Wi-Fi instead of only USB?

The project adds a USB and Wi-Fi backup workflow.

Answers sourced from github.com

Community

Collected 44 days ago - public community threads