How to Migrate Your Data From macOS to elementary OS
Moving from macOS to elementary OS is easier when you treat it as a data migration project rather than a simple operating system installation. Your documents, photos, music, browser profiles, email archives, passwords, and application settings may be stored in several different places, and each category needs a slightly different method.
elementary OS provides a clean Linux desktop based around the Pantheon experience, but its applications and file-management conventions differ from macOS. A careful transition gives you time to identify what you actually use, replace incompatible software, and keep a reliable copy of your original files while you learn the new system.
The safest approach is to inventory your Mac, create at least one independent backup, copy personal files in broadly compatible formats, and then configure elementary OS in stages. You can begin using the new system without immediately erasing the old one, which makes troubleshooting much less stressful.
Prepare Your Mac Before Installation
Start by creating a complete backup of the Mac. Time Machine is useful for recovering the original computer, but it should not be your only migration copy because browsing Time Machine data from Linux is less straightforward than restoring it to another Mac. Use an external drive for a second copy of your personal files, and verify that important folders open from the backup.
Make a list of accounts, services, applications, and devices you use regularly. Include your Apple ID, email providers, cloud storage accounts, password manager, VPN, printer, scanner, development tools, creative applications, and subscription software. This inventory helps distinguish data that must be copied from applications that need a Linux replacement.
Sign out of services only after you have confirmed that the necessary data is available elsewhere. For example, disabling iCloud Drive too early can leave files represented by placeholders rather than full local copies. Open Finder, select important folders, and confirm that their contents are downloaded before copying them to external storage.
Choose A Transfer Drive And File Formats
The simplest shared-storage option is usually an external drive formatted as exFAT. macOS and elementary OS can both read and write exFAT without the restrictions associated with a Mac-specific file system. FAT32 also works across platforms, but its four-gigabyte file-size limit makes it unsuitable for large video files, disk images, and some virtual-machine data.
APFS and HFS+ are excellent choices for a Mac backup, but they are less convenient as a long-term exchange format on Linux. elementary OS may be able to read some Mac-formatted volumes with additional tools, yet relying on that during a migration introduces avoidable uncertainty. Copy the data from the Mac to an exFAT drive, then eject the drive properly before connecting it to the elementary OS computer.
Keep filenames conventional while transferring. Linux supports many characters that cause problems elsewhere, but filenames containing slashes, trailing spaces, or unusual control characters can still create confusion. If a folder contains thousands of files, copy it in smaller groups and compare the source and destination sizes afterward.
Do not use a cloud-synchronized folder as your only transfer method. Services such as Dropbox, Google Drive, and OneDrive can help restore files after installation, but sync conflicts, online-only placeholders, and authentication problems can delay access. An offline copy gives you a stable reference while you configure cloud applications on elementary OS.
Move Documents, Photos, Music, And Video
Personal files are generally the easiest part of the transition. Copy your Desktop, Documents, Downloads, Movies, Music, and Pictures folders to the external drive. Also check less obvious locations such as project folders, archived messages, game saves, virtual machines, SSH keys, and files stored directly in the home directory.
Photos deserve extra care. If you use Apple Photos, exporting the original files is preferable to dragging a Photos Library package to Linux. The library may contain edits, albums, face data, and other metadata that a Linux photo manager cannot interpret completely. In Photos, export unmodified originals when preserving the camera files matters, or export edited versions when you want the appearance you currently see.
Apple’s HEIC and HEIF image formats may need conversion for applications that expect JPEG or PNG. Keep the originals, but consider generating broadly compatible copies for everyday use. Videos exported from iMovie or Final Cut should be rendered into common formats such as H.264 video with AAC audio when compatibility is more important than retaining an editable project.
Music libraries require a similar distinction between media and catalog data. Copy the actual audio files and inspect whether they are DRM-free. Apple Music subscriptions, playlists, ratings, and downloaded protected tracks may not transfer directly. Export playlists when possible, then import the audio into a Linux music player after verifying that your files are stored locally.
Bring Over Browsers, Mail, And Passwords
Browser data can often be migrated without copying an entire macOS profile. Sign in to Firefox, Chromium, or another supported browser and allow bookmarks, history, extensions, and settings to synchronize. You can also export bookmarks as an HTML file and import them manually. Treat browser passwords separately: use the browser’s encrypted sync feature or export them only temporarily into a protected location.
A dedicated password manager is usually the cleanest bridge between operating systems. Install its Linux application or use its web interface, sign in, and confirm that your vault is complete before removing the old installation. Avoid placing an unencrypted password export on a shared drive, and delete any temporary CSV file after importing it.
Email migration depends on whether you use IMAP, a hosted service, or local archives. IMAP mailboxes normally reappear when you configure the same account in a Linux mail client. Local Apple Mail folders may require export or conversion, particularly if messages exist only on the Mac. Keep the original mail archive untouched until you have tested searching, attachments, folders, and sent-message history.
Calendar and contact data should be checked independently. Cloud accounts using standard synchronization protocols may work immediately, while Apple-specific services can require a browser, a compatible calendar client, or manual export. Save contacts as vCard files and calendars as standard calendar files when those options are available.
Recreate Your Software Environment
Applications themselves cannot usually be copied from macOS to elementary OS. macOS application bundles depend on Apple frameworks, so dragging an application to Linux will not make it executable. Instead, create a replacement list based on tasks: writing, image editing, video playback, coding, accounting, communication, and file synchronization.
The AppCenter and compatible Linux software repositories provide many options, while Flatpak can supply additional desktop applications in a self-contained format. Prefer established applications with active maintenance and clear data-storage locations. Before importing a large library into a replacement app, test it with a small sample and confirm that edits, metadata, and exports behave as expected.
| macOS Activity | Possible elementary OS Approach | Migration Detail |
|---|---|---|
| Web browsing | Firefox, Chromium, or another Linux browser | Sync or export bookmarks, passwords, and extensions |
| Office documents | LibreOffice or a web office suite | Check fonts, formulas, and document layout |
| Photo organization | A Linux photo manager or file-based folders | Export originals and preserve metadata |
| Music playback | A local music player or streaming application | Copy DRM-free audio and rebuild playlists |
| Video editing | A Linux-compatible editor | Export finished projects and keep source media |
| Cloud storage | Official Linux client, web app, or supported sync tool | Reconnect after confirming local backups |
| Development work | Native Linux toolchains and editors | Recreate packages, keys, containers, and scripts |
Some macOS applications have no direct equivalent. Specialized professional tools, legacy utilities, and software tied to Apple hardware may require a web service, a remote Mac, dual booting, or a virtual machine. Keep the old Mac available until you have completed a real task in the replacement application rather than assuming compatibility from its feature list.
If you work with fonts, copy legally transferable font files and install them through the desktop’s font manager or the appropriate user font directory. Proprietary fonts may have licensing restrictions, so do not assume that a font included with macOS can be redistributed freely.
Restore Files Safely On elementary OS
After installing elementary OS, connect the transfer drive and open it in the file manager. Create a clear folder structure in your home directory before copying everything. For example, separate personal documents from application data, archived installers, temporary exports, and files that still need review.
Copy important material in stages. Begin with documents and a small selection of photos, open them in their intended applications, and check filenames, permissions, dates, and embedded metadata. Once the process works as expected, transfer larger collections. This approach makes it easier to identify whether a problem comes from the drive, a particular file type, or an application.
Linux permissions may look unfamiliar when files come from a removable drive. Your personal files should normally be owned by your user account, but files copied from another system can occasionally have unexpected ownership or read-only attributes. If you cannot edit a copied file, inspect its properties before changing permissions broadly. Avoid running file operations as administrator unless you understand exactly what they will modify.
Some Mac files are packages that appear as single items in Finder but are actually directories. Photos libraries, application bundles, and certain project files may expose their internal contents when viewed on Linux. Do not edit those internals casually. Treat the package as an archive and use an export function whenever the original application provides one.
Your desktop experience may feel different even when the underlying tasks are familiar. elementary OS emphasizes a focused workflow, consistent application design, and a dock-based launcher. If you are comparing Linux desktops before settling into your new setup, this guide to desktop environment differences can help explain why Pantheon may feel different from macOS or GNOME.
Reconnect Cloud Accounts And Devices
Once local files are secure, reconnect your online accounts one at a time. Start with email and password management, then add cloud storage, calendars, messaging services, and work accounts. After each connection, confirm that synchronization is going in the intended direction. A newly configured sync client can remove or replace remote files if it is pointed at an empty local folder with the wrong settings.
Cloud storage may need a different workflow on Linux. Some providers offer a native client, while others work through a browser or integration with the file manager. For large libraries, allow synchronization to finish before treating the local copy as a backup. Use selective sync when disk space is limited, but remember that online-only files are unavailable without an internet connection.
Printers, scanners, phones, and external displays should be tested separately. Many common devices work automatically, but proprietary utilities may be macOS-only. For an iPhone, local file access and media synchronization are more limited than on a Mac, so decide whether you will use cloud photo storage, a web interface, network transfer, or another supported tool.
Review your privacy and security settings after migration. Enable automatic updates, use a strong login password, configure screen locking, and consider full-disk encryption if it was not selected during installation. Store recovery information safely, and keep the original Mac backup disconnected when it is not being used.
Keep A Verification Window
Do not erase the Mac or repurpose the transfer drive immediately. Use elementary OS for several days or weeks while performing normal activities: opening older documents, editing photos, joining meetings, printing, accessing financial records, and restoring files from your backup. A migration is complete only when the tasks that matter to you work reliably.
Maintain a simple checklist of items that have been tested. Mark off personal files, browser data, mail, calendars, contacts, cloud services, application replacements, hardware, and backups. If something is missing, return to the Mac while the source data is still available instead of trying to reconstruct it from memory.
After the verification period, create a fresh backup of your elementary OS home directory. Include configuration files only when you know they contain useful settings, and exclude caches and temporary directories where practical. A rotating backup routine protects your new Linux installation just as the original Mac backup protected the old one.
Keep one archival copy of irreplaceable photographs, legal records, creative work, and family documents in a separate location. Test that archive occasionally. A drive that has never been opened since migration is only an assumed backup, not a verified one.
When your files, accounts, and daily applications are working comfortably, begin using elementary OS as your primary environment and retain the Mac as a fallback until you no longer need it. Follow the process in small, testable stages, preserve the original data, and record the replacement applications and settings that make your new Linux desktop your own.