Skip to content
On this page

Cloud Sync

Paperlib use MongoDB Atlas as the cloud database backend. You can create your own cloud database and use it to sync your Paperlib data across your devices. The free tier of MongoDB Atlas is enough for Paperlib. When everything is set up, you can safely store the metadata of your papers in the cloud without any maintenance operation.

Create a MongoDB Atlas DB

  1. Open https://account.mongodb.com/account/login, sign up and login to your account.

  1. Choose the free dataset plan.

  1. Create a database, select the best server location according to your country.

  1. set the superuser of the database.

  1. Go to the App Services page, create a APP.

Connect Atlas, rename your APP, select location for deployment.

6.Since then, the MongoDB Atlas is ready.

Create a User

A User is a person who can access the cloud database.

  1. In Realm Tab, click App Users, click Authentication Providers.

  1. Turn on the Email Password Authentication. Choose Automatically confirm users as the user confirmation method. Password Reset URL is not required, just leave a random URL. Click Save Draft.

  1. Click the upper banner REVIEW DRAFT & DEPLOY to apply previous settings.

  1. Back to the User page, Click Add New User to create a user.

  1. Sinc then, you've created a user.

Create a Data Table.

The data scheme can be automatically created based on the data sent by the Paperlib APP.

  1. In the Device Sync page, click Start Sync. It enables the your APP to sync data with the backend database cluster. In the popup dialog, click No thanks, continue to Sync.

  1. Open the Development Mode to allow MongoDB Altas automatically create data scheme based on the data sent by the Paperlib APP. Other configurations are as shown below.

⚠️ Please uncheck the require checkbox of partition.

  1. Click Enable Sync.

  2. Click the upper banner REVIEW DRAFT & DEPLOY again.

  3. Since then, the cloud database is ready.

Connect Paperlib to your MongoDB Atlas DB

  1. Open the preference window of Paperlib, click Cloud tab, input your MongoDB Atlas APP ID, email and password of the user you created.

  1. Click Login. If the sync is successful, you can see some writing logs after importing a paper to Paperlib.


Now, everthing is ready, enjoy Paperlib with cloud sync.

Sync PDF Files

Since PDF storage may cost a lot of cloud space, we recommand to use onedrive (or dropbox etc.) or webDAV to sync your PDF files accross devices.

For example, on device A, choose C:/Onedrive/mypaperlib as your library folder. On the other device B, choose /user/xxx/Onedrive/mypaperlib as the library folder.

Released under the GPL-3.0 license. hi@paperlib.app