# When something doesn't sync

> What to check when reading, highlights, or books don't come through, and where to find out what happened.

Canonical: https://boeks.app/docs/guides/troubleshooting

Most sync problems come down to a folder that isn't syncing everything, or devices that can't see each other. Here's what to check, roughly in order.

## See what happened

- **On your Mac and iPhone,** **Devices** lists each device with when it was last active and last synced.
- **On your Mac,** a device's page has **Show Log**, with what it did at each sync and why it skipped anything.
- **On your Kobo,** Boeks's logo in the status bar shows what the last sync over Wi-Fi or USB brought in, book by book, when you tap it. **Boeks** in the reader's menu shows the book's timeline across your devices.

## Your library folder

Your devices share reading through small files in your library's hidden `.boeks` folders.

- **Hidden folders are skipped.** Some sync services and tools leave out files whose names start with a dot, Nextcloud among them, unless you tell them not to. Make sure yours syncs the `.boeks` folders.
- **Books aren't downloaded.** iCloud Drive can keep books only in the cloud to save space on your iPhone. Your iPhone sends a book to your Kobo once it's downloaded there.
- **The service hasn't caught up.** A change shows on your other devices once your sync service has copied it, which can take a moment, or longer on a slow connection.
- **Conflicted copies** that some services make, like `name (conflicted copy).jsonl`, are rare with Boeks: each device writes only its own files. If you see one, tell us.

## Over Wi-Fi

- **Keep Boeks open.** Your Mac answers while Boeks is open there; your iPhone and iPad only while Boeks is on screen.
- **Use the same network.** Some networks, such as guest Wi-Fi in hotels or offices, keep devices from seeing each other. Your iPhone's Personal Hotspot works instead: join it from your Kobo.
- **Allow the local network.** Boeks asks the first time. If you said no, turn it on in your iPhone's Settings › Privacy & Security › Local Network, or in your Mac's Privacy & Security settings.
- **Pair your Kobo once.** A Kobo syncs over Wi-Fi after it has been connected to your Mac with Boeks once. See [Install Boeks on a Kobo](/docs/guides/install-on-a-kobo).

## Your Kobo

- **After a firmware update,** Boeks may be gone from your Kobo. Connect it to your Mac and install it again; your reading is kept in your library.
- **On firmware 5,** Boeks for Kobo doesn't work yet. It needs firmware 4.
- **A book doesn't show on the Kobo.** If Boeks couldn't convert it, the Kobo says so, with the reason. Books with DRM aren't sent.
- **Pages don't turn** from your iPhone or Apple Watch: turn on Bluetooth on the Kobo and keep it awake with a book open. Page turning works on the [Kobos with Bluetooth that Boeks supports](/docs/guides/turn-pages).

## If it still doesn't work

Email [support@boeks.app](mailto:support@boeks.app). On your Mac, a device's log (**Show Log**) helps us see what happened.
