Sync across devices

Sync is optional and shares supported sources and their settings, share connections, bookmarks, and reading progress across devices.

Book files and downloads

Book files and downloaded chapters still need to be available on each device.

You need a compatible custom server or a configured Supabase project. Use the connection details for your service.

Choose a sync service

1. Open Settings → Sync.
2. Choose Custom Server or Supabase as the Sync Engine. Leave it at None if you do not need sync.
3. Complete the appropriate setup below.

Choose a sync engine

Screenshot device — Choose a sync engine

iPhoneiPad

Sync engine menu with None, Custom Server, and Supabase on iPhone.

Sync engine menu with None, Custom Server, and Supabase on iPad.

iCloud (coming soon)

iCloud availability

iCloud sync is not available yet. Use Custom Server or Supabase to sync across devices.

Custom Server

Before using Custom Server sync, set up a compatible server using either of these repositories:

• Mankai Sync: A dedicated sync server with user accounts defined in config.json.
• Mankai Server: A manga library server that also supports bookmarks and reading progress sync.

Follow the setup instructions in your chosen repository.

Server URL

For Mankai Sync, use the server’s root URL, such as http://<host>:3000. For Mankai Server, use its API URL, such as http://<host>:3000/api.

Use the username and password for an account on that server. If you use an existing service, ask its administrator for these details.

1. Select Custom Server and enter the appropriate URL in Server URL.
2. Tap Save Configuration.
3. Enter your username and password under Credentials.
4. Tap Log In.

Supabase

You can use Mankai’s Supabase project with these connection details:

• Project URL: https://wblemlisleehqgikztlm.supabase.co
• Publishable key: sb_publishable_-Cw5SX-GcpvRd17ikISEMw_Zb4Y5UW1

Free tier availability

Mankai’s Supabase project runs on the free tier. It may not work and may be paused at any time.

Using your own Supabase project

To use your own Supabase project, follow the setup instructions in the Mankai Supabase repository to apply the database migrations and configure an OAuth sign-in provider. If you use another existing configured project, ask its administrator for the project URL and publishable key.

1. Select Supabase and enter the project URL and publishable key.
2. Tap Save Configuration.
3. Choose the sign-in provider configured for that project and tap Log In.
4. Complete the sign-in flow and return to Mankai.

Check what each source can sync

Open Settings → Sources and select a source, or Settings → Shares and select a share. The Sync section shows separate statuses for the source’s settings and its manga records:

Status	When Enabled
Sync source across devices	Installs the source and syncs its settings on your other devices.
Sync share across devices	Syncs the share’s connection settings to your other devices.
Sync manga across devices	Syncs library entries (bookmarks) and reading progress for manga from that source.

Automatic sync statuses

These are automatic capability indicators. If a status is Disabled, the explanation below it tells you why that part cannot sync.

Check source sync support

Screenshot device — Check source sync support

iPhoneiPad

Source settings and manga sync both shown as Enabled for Mankai Server on iPhone.

Source settings and manga sync both shown as Enabled for Mankai Server on iPad.

Sync both devices

1. Once the status is Active, tap Sync Now.
2. Check that the last sync time updates successfully.
3. Configure the same service and account on your other device, then tap Sync Now there too.
4. Check Settings → Sources and Settings → Shares for the supported sources and share connections restored by sync.
5. Add any File System sources or sources without a usable download URL manually, and confirm that the other device can open the same books.
6. Open a supported book and tap Continue to pick up where you left off.

Check sync status

Screenshot device — Check sync status

iPhoneiPad

Active sync status, the last sync time, and Sync Now on iPhone.

Active sync status, the last sync time, and Sync Now on iPad.

Keep source identities consistent

Shares use a .mankai file to identify the same source across devices.

Source identity limits

If Mankai cannot write that file, the source uses a local identity and its bookmarks and reading progress do not sync. OPDS uses the catalog’s ID and falls back to a local identity if the catalog has none. The built-in Local Directory keeps its bookmarks and reading progress on that device.

Matching share names alone do not make two sources the same. Their source IDs must also match. A folder can sync its connection settings even when a local identity prevents its manga records from syncing. A synced bookmark also needs its source and book to be available on the other device before you can open it.

When a source or reading progress does not appear

Confirm that both devices use the same account and show a successful sync. Check the source’s Sync section for both settings sync and manga sync support. Add File System sources and sources without a usable download URL manually, and make sure the source is reachable on the other device. If only bookmarks or progress are missing, check whether the source uses a local identity. Read Troubleshooting before resetting your connection settings.