# Synchronizing with a file

While other options allow the synchronization between smartphones and computers, synchronizing with a file is only possible between computers.

In this option, a sync file is created in Mapeo Desktop on one computer and then it is used by another computer with Mapeo to exchange data. During the synchronization, all data contained in the sync file is transferred to the computer that is syncing with it, and all data in the Mapeo database of the computer will also be transferred to the sync file. It uses the same two-way method as synchronization via Wi-Fi. To learn more about how synchronization works, see [peer-to-peer-and-mapeo-sync](https://docs.mapeo.app/~/changes/iOm3AFqdVz8g9c1IDE5m/overview/about-mapeo/peer-to-peer-and-mapeo-sync "mention").

* **If devices are near** each other, this is a good sync option when you can't create a local Wi-Fi network. You can instead use a <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive to copy and paste the sync file between different devices. It works with <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FQp54LKiQ8q6BmcYZAU7l%2Fimage.png?alt=media&#x26;token=7cf44330-57a0-4323-8f8c-6c4fbb4868de" alt="" data-size="line">**no internet connection**.
* **If devices are not near** each other, this is also a good sync option. In this case, you will either need to transport a <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive to the location of the second device or have access to an <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F9tuesSEYJuwr2RzxOqXe%2FComputer-no-internet-icon.png?alt=media&#x26;token=6b969329-1dab-4097-a6ed-cc0afc6ea9d1" alt="" data-size="line">internet connection.&#x20;

Other requirements:&#x20;

* **Both devices must be using the same configuration**\
  It is only possible to sync with sync files created by devices that use the same [configuration](https://docs.mapeo.app/~/changes/iOm3AFqdVz8g9c1IDE5m/will-mapeo-work-out-of-the-box-for-me/default-configuration#about-configurations). For more on how to import configurations, see[importing-configurations](https://docs.mapeo.app/~/changes/iOm3AFqdVz8g9c1IDE5m/complete-reference-guide/mapeo-desktop-installation-setup/importing-configurations "mention")[importing-configurations](https://docs.mapeo.app/~/changes/iOm3AFqdVz8g9c1IDE5m/complete-reference-guide/mapeo-mobile-installation-setup/importing-configurations "mention").

## Create a sync file

1. Open <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FFAdFfIFGpMRnNzVDcK6i%2FMd-icon.png?alt=media&#x26;token=f55b5fc0-8c3c-42e4-ad1b-02b2aa4a7889" alt="" data-size="line"> Mapeo Desktop on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F7NkfOdadFjuNRzbI4imN%2Flaptop-icon.png?alt=media&#x26;token=d3ccde3e-3202-4dd8-82e5-107b9dbe50ce" alt="" data-size="line"> computer 1, the computer on which you want to create a sync file. The generated sync file will include **all** the Mapeo data from that computer.
2. Click on **Synchronize** on the **Mapeo modes** panel

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FeVDEfogCDZh0tSqR1mAw%2FMd_Synchronize_mode.jpg?alt=media\&token=c8afe1d9-c6bf-430d-b094-ecf23d16d0bc)

3\. Click on the **Create a sync file** button and choose the name and location where the generated file will be saved.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F4kJJnLKfkkF41kESCdFC%2FMd_sync_create_syncfile.jpg?alt=media\&token=b9e2c2c2-5211-4713-b9a7-d7115aea7535)

## Send or copy the sync file to the second device

There are two options for sharing a sync file:

* [**Send sync file via email or file sharing service**](#send-sync-file-via-email-or-file-sharing-service)\
  (Requires an <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F9tuesSEYJuwr2RzxOqXe%2FComputer-no-internet-icon.png?alt=media&#x26;token=6b969329-1dab-4097-a6ed-cc0afc6ea9d1" alt="" data-size="line">internet connection)
* [**Copy and paste sync file using a USB drive**](#option-2.-copy-pasting-it-among-different-devices-with-no-internet-connection-you-will-need-a-usb-dr)\
  (Works with <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FQp54LKiQ8q6BmcYZAU7l%2Fimage.png?alt=media&#x26;token=7cf44330-57a0-4323-8f8c-6c4fbb4868de" alt="" data-size="line">no internet connection)

#### **Option 1. Send sync file via email or file sharing service**

![Computer 1 (black) generates sync file and sends it via email to Computer 2 (blue).&#x20;
Computer 2 then syncs with the file. ](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FSvLEeNDDcGYTkImBEj85%2Fsync%20file%20via%20internet.jpg?alt=media\&token=5c0f0600-bb30-43bc-a277-2ccc9b2e651f)

1. Locate the generated sync file on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F7NkfOdadFjuNRzbI4imN%2Flaptop-icon.png?alt=media&#x26;token=d3ccde3e-3202-4dd8-82e5-107b9dbe50ce" alt="" data-size="line"> computer 1.
2. In your email app (<img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FmvUomXGaeDUWSDEUTQTz%2FGmail-logo.png?alt=media&#x26;token=49125f0b-72b0-4de3-80d2-93b0a673e094" alt="" data-size="line">Gmail, <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F5UvmDWr7doC7YoJ6LGok%2FHOTMAIL%20(1).jpg?alt=media&#x26;token=428bc85b-a847-4c22-835b-3d2248b2c3d3" alt="" data-size="line">Hotmail, etc.), create a new email and attach the sync file. Send it to the user of the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line"> computer 2, the computer with which you want to sync.
3. <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line"> Computer 2 must receive the sync file and save it. It is important to remember where has it been saved.

{% hint style="info" %}
If the sync file is too large to be sent by email, you can use other platforms such as <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FgYl2rw9vgbx1oh20tshF%2FWE%20TRANSFER.png?alt=media&#x26;token=b77f4bab-6d24-4a21-a97b-cced7cadc200" alt="" data-size="line"> [WeTransfer](https://wetransfer.com), <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FzA7d7fAWS9WR56CynJMY%2Fdrive.png?alt=media&#x26;token=48f81ba9-8aa0-478a-916d-e0865cd27ed9" alt="" data-size="line"> [Google Drive](https://www.google.com/drive/), or <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F72NTw1Zdz9plyygT2ELU%2FDROPBOX.jpg?alt=media&#x26;token=3745ef87-27ef-450a-8afb-c763e37e94bb" alt="" data-size="line">[Dropbox](https://www.dropbox.com). You can send files up to 2GB for free using these apps.
{% endhint %}

#### **Option 2. Copy and paste sync file using a USB drive**

![Computer 1 (black) generates sync file and transfers it via USB drive to Computer 2 (blue).
Computer 2 then syncs with the file.](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2Fjs9WnFvKFdPFS3FuHMfT%2Fsync%20file%20via%20usb%20\(1\).jpg?alt=media\&token=bf8dde93-fd9b-4448-a095-ca3459641d89)

* Connect a <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive to <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F7NkfOdadFjuNRzbI4imN%2Flaptop-icon.png?alt=media&#x26;token=d3ccde3e-3202-4dd8-82e5-107b9dbe50ce" alt="" data-size="line"> computer 1, where you generated the sync file.
* Locate the generated sync file on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F7NkfOdadFjuNRzbI4imN%2Flaptop-icon.png?alt=media&#x26;token=d3ccde3e-3202-4dd8-82e5-107b9dbe50ce" alt="" data-size="line"> computer 1 and click on it using the right button of the mouse. Select **Copy**.
* Navigate to the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive in the file system. Right-click on the location and select **Paste** to paste the sync file onto the drive.
* Disconnect the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive and connect it to the computer you want to sync with (<img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line"> computer 2).
* Navigate to the <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FHqBKmcRbFkmWEbwH64md%2Fimage.png?alt=media&#x26;token=253323a4-7697-4e9c-a5ac-8b62ebc7bc4d" alt="" data-size="line">USB drive folder and locate the sync file. Right-click on the file and select **Copy**. Navigate to where you would like to save the sync file on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line"> computer 2. Right-click on the location and select **Paste**.

## Start synchronization

1. Locate the received or pasted sync file on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line"> computer 2, the computer you want to sync with.
2. Open <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FFAdFfIFGpMRnNzVDcK6i%2FMd-icon.png?alt=media&#x26;token=f55b5fc0-8c3c-42e4-ad1b-02b2aa4a7889" alt="" data-size="line"> Mapeo Desktop on <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line">computer 2.
3. Click on **Synchronize** in the Mapeo modes panel.

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FeVDEfogCDZh0tSqR1mAw%2FMd_Synchronize_mode.jpg?alt=media\&token=c8afe1d9-c6bf-430d-b094-ecf23d16d0bc)

4\. Click on the **Sync from a file** button and in the pop-up window, navigate until you find the desired sync file. Then click on it and click **Open**.Start synchronization

![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FjjIrQpO98iHaY4rZmRCR%2FMd_sync_from_file.jpg?alt=media\&token=cf9f63d1-7d30-4ecf-b7b6-5c73ffdece86)

The synchronization with the file will automatically begin.&#x20;

{% hint style="warning" %}
**Important**: Keep the **Synchronize** screen open on both devices until the synchronization process is complete.
{% endhint %}

{% hint style="info" %}
When the synchronization is complete, <img src="https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2FI5Q259BlYwCenpqfeomu%2Flaptop-blue-icon.png?alt=media&#x26;token=ddecd9d0-7f49-4e80-8c04-0ccedcd22cc8" alt="" data-size="line">computer 2 and the sync file will have identical copies of the Mapeo database. To complete a 2-way synchronization between the two computers, repeat the process to copy the sync file back to ![](https://3796244665-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYBEBKX0wx5_bwmCf0q-887967055%2Fuploads%2F7NkfOdadFjuNRzbI4imN%2Flaptop-icon.png?alt=media\&token=d3ccde3e-3202-4dd8-82e5-107b9dbe50ce) computer 1 and use it to **Sync from a file**.
{% endhint %}

### View synced observations

To learn about viewing and managing synchronized data in Mapeo Desktop **Observations** mode, continue to:

{% content-ref url="../viewing-observations" %}
[viewing-observations](https://docs.mapeo.app/~/changes/iOm3AFqdVz8g9c1IDE5m/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/viewing-observations)
{% endcontent-ref %}
