Guides
Everything you need to set up floccus — from installing the extension to choosing a sync method.
Getting started
With floccus you can synchronize your bookmarks across all your devices and browsers. Floccus is not so much a bookmarks manager -- it doesn't give you a managing interface, you can use the browser to sort and cleanup your bookmarks, like you always have. Floccus is just a syncing tool: It synchronizes your browser's native bookmarks and gets out of the way.
For this to work you need a syncing server, a middle man, if you will, that all your devices can access. Floccus currently offers some choice here. The simplest choice is to go and use Google Drive for this. If you don't want Google to know your bookmarks, just encrypt them.
If you prefer Dropbox, you can store your bookmarks there instead, also optionally encrypted.
If you don't have Google Drive or Dropbox or don't want to use them, using WebDAV may be an option. There are many cloud storage services out there that support WebDAV. Checkout this list the Cryptomator Community created to see if your provider offers WebDAV.
If you have access to an S3 bucket, e.g. on Amazon S3, Cloudflare R2, Backblaze B2 or your own MinIO or Garage server, you can store your bookmarks there, also optionally encrypted.
If you'd rather keep your bookmarks in a Git repository, e.g. on GitHub, GitLab or Gitea, you can sync via Git as well.
If you want a very easy solution, you can sync your bookmarks via Linkwarden. Linkwarden is an Open Source web app that manages your bookmarks. You can host it yourself on your own server, but you can also simply signup on their hosted solution at linkwarden.app. You can then also access and manage your bookmarks on the go, say from an internet café in Malawi, by simply logging into Linkwarden with any web browser. Karakeep is another open source bookmarks manager that you can host yourself and sync with floccus in the same way.
Similar to Linkwarden, but perhaps a bit more involved is syncing via Nextcloud Bookmarks. Nextcloud is an open source cloud collaboration tool that you can self-host or rent as a service. Nextcloud offers a multitude of apps to collaborate and share work over, chief amongst them, the Bookmarks app. If you have a Nextcloud installation available, try installing the Bookmarks app and set up floccus to sync with it.
Floccus is known to work in Chrome, Firefox, Edge, Opera, Vivaldi, Brave and Orion. Click on one of the following links to install floccus in your browser.
- Chrome Webstore (also applies for Opera, Vivaldi, Brave and Orion)
- Mozilla Addons
- Edge Addons
Your browser will ask you to confirm installation, including the permissions necessary for running floccus. Floccus currently requires the following permissions:
| Permission | Explanation |
|---|---|
| storage, unlimitedStorage | Necessary for maintaining a cache and mappings between server and browser bookmarks |
| alarms | Necessary for triggering synchronization in regular intervals |
| bookmarks | Necessary for creating and reading bookmarks |
| Unlimited web access | Also sometimes called "read and change data on all websites". Necessary for accessing your self-hosted server. This cannot be limited, because everybody's server has a different URL. Unfortunately, the way webextensions work currently, floccus also gets access to all the data the browser has collected on those websites. However, floccus makes no use of that data and doesn't in any way collect information about you. |
| identity | Necessary for connecting with Google Drive |
| tabs and tabGroups | Necessary for syncing tabs and tab groups |
| history (optional) | Necessary for sending statistics about which links you click to Nextcloud Bookmarks (this feature is opt-in) |
| notifications (optional) | Necessary for showing a system notification when a profile set to "Only notify me about changes" has changes waiting (this feature is opt-in) |
Floccus for Android is available from
Like Floccus in the browser, Floccus for Android allows you to create and manage multiple profiles.
For technical reasons, the App does not sync your bookmarks with your mobile browsers, but makes them available directly in the app itself instead.
You can share links from your browser or other apps to the Floccus App for bookmarking, create and browse folders and search like you would in your browser and open links in your favorite browser.
Floccus for iPhone and iPad is available from
Like Floccus in the browser, Floccus for iOS allows you to create and manage multiple profiles.
For technical reasons, the App does not sync your bookmarks with Safari or other mobile browsers, but makes them available directly in the app itself instead.
You can share links from Safari or other apps to the Floccus App for bookmarking, create and browse folders and search like you would in your browser and open links in your favorite browser.
Choose a sync method
- Create a new profile in the Floccus panel
- Select Nextcloud Bookmarks as your sync method
- The following screen shows the profile settings.
- First you will need to enter your nextcloud URL. This should be the url that you use to access your nextcloud, e.g. https://mycloud.provider.com
- Then enter your username and password. If you want to create a separate app password for floccus, click the "Sign in with Nextcloud" button in the user name field, which will direct you to your Nextcloud instance to approve the generation of an app password.

- Now, you can configure the folder mapping. You can set one local bookmarks folder and one server folder per profile.

- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
- Create a new profile in the Floccus panel
- Select Linkwarden as your sync method
- Optionally set a name for your new profile.
- The following screen shows the connection settings.
- First you will need to enter your Linkwarden URL. This should be the root URL of your Linkwarden server, e.g. https://cloud.linkwarden.app/ for the publicly hosted instance by the linkwarden devs. The URL should end with a slash.
- Then enter your username and an access token. Entering your account password will not work, instead you have to generate a specific access token in the linkwarden settings for floccus.
- Enter the name of a collection to sync to. All your bookmarks as well as any folders you have will be created under this collection.
- Finally, you can choose which bookmarks folder to sync to that collection. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
- Create a new profile in the Floccus panel
- Select Karakeep as your sync method
- Optionally set a name for your new profile.
- The following screen shows the connection settings.
- First you will need to enter the URL of your Karakeep server, e.g. https://karakeep.example.com
- Then enter an API key. Entering your account password will not work, instead you have to generate an API key in the Karakeep settings for floccus.
- Enter the name of a list to sync to (by default “Floccus”). All your bookmarks as well as any folders you have will be created under this list. Only links under this list will be synced with your browser.
- Finally, you can choose which bookmarks folder to sync to that list. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
Note that Karakeep can only sync http(s): links, does not keep the order of your bookmarks across syncs and cannot be used with end-to-end encryption.
- Create a new profile in the Floccus panel
- Select XBEL in WebDAV as your sync method
- The following screen shows the profile settings.
- First you will need to enter your WebDAV URL. This should be the root URL of your WebDAV server, e.g. https://webdav.provider.com. The URL should end with a slash. Here’s a list of the URLs for the most common public providers.
- Then enter your username and password.
- If you’d like to encrypt your data before storing it on the server, you can set a passphrase here. If you don’t enter anything, it won’t be encrypted.
- Finally, you can choose which bookmarks folder to sync to that file. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.

- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus
- Create a new profile in the Floccus panel
- Select Google Drive as your sync method
- The following screen shows the profile settings.
- First you will need to connect floccus with your Google account. After clicking “Login with Google”, you will need to sign in and grant floccus access to your Google Drive.
- The next option allows you to specify the name of your bookmarks file in your Drive storage. Only enter the file name, not a full path, and make sure the name is unique in your Drive. By default floccus will place a file called bookmarks.xbel in your topmost folder.
- If you’d like to encrypt your data before storing it in your Drive, you can set a passphrase here. If you don’t enter anything, it won’t be encrypted.
- Finally, you can choose which bookmarks folder to sync to that file. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
- Create a new profile in the Floccus panel
- Select Dropbox as your sync method
- The following screen shows the profile settings.
- First you will need to connect floccus with your Dropbox account. After clicking “Login with Dropbox”, you will need to sign in and grant floccus access to your Dropbox.
- The next option allows you to specify the name of your bookmarks file in your Dropbox. Only enter the file name, not a full path, and make sure the name is unique in your Dropbox. By default floccus will create a file called bookmarks.xbel.
- If you’d like to encrypt your data before storing it in your Dropbox, you can set a passphrase here. If you don’t enter anything, it won’t be encrypted.
- Finally, you can choose which bookmarks folder to sync to that file. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
Floccus can store your bookmarks in a file in an S3 bucket. This works with Amazon S3 as well as any S3-compatible storage, e.g. Cloudflare R2, Backblaze B2, Wasabi, Hetzner Object Storage, MinIO or Garage. S3 sync is available since floccus v5.13.
Before you start
- Create a bucket with your storage provider. Floccus will not create the bucket for you, it has to exist already. Don't make the bucket public, floccus doesn't need that. You also don't need to configure CORS for the bucket.
- Create an access key for floccus. You will get an access key ID and a secret access key. It's a good idea to create a dedicated key that can only access this one bucket. Floccus needs permission to list the bucket and to read, write and delete objects in it (on Amazon S3 these are
s3:ListBucket,s3:GetObject,s3:PutObjectands3:DeleteObject). - Find out the endpoint URL and the region of your bucket. Here are the values for some common providers:
| Provider | Endpoint URL | Region | Path-style URLs |
|---|---|---|---|
| Amazon S3 | https://s3.REGION.amazonaws.com |
e.g. eu-central-1 |
on or off |
| Cloudflare R2 | https://ACCOUNT_ID.r2.cloudflarestorage.com |
auto |
on |
| Backblaze B2 | https://s3.REGION.backblazeb2.com |
e.g. eu-central-003 |
on or off |
| Wasabi | https://s3.REGION.wasabisys.com |
e.g. eu-central-1 |
on or off |
| Hetzner Object Storage | https://LOCATION.your-objectstorage.com |
e.g. fsn1 |
on or off |
| MinIO, Garage and other selfhosted servers | The URL of your server, e.g. https://s3.example.com |
The region configured on your server, otherwise us-east-1 (MinIO) or garage (Garage) |
on |
Setting up the profile
- Create a new profile in the Floccus panel
- Select S3 bucket as your sync method
- Enter the S3 endpoint URL. This is the URL of your S3 service without the bucket name, e.g.
https://s3.eu-central-1.amazonaws.com. The URL must start with https:// (or http:// for a local server). - Enter the Region your bucket is in. Use
autofor Cloudflare R2 andus-east-1if your provider doesn't use regions. - Enter the name of your Bucket. Only enter the name, without any slashes.
- Choose whether to Use path-style URLs. With path-style URLs floccus accesses your bucket at
ENDPOINT/BUCKET, otherwise atBUCKET.ENDPOINT. Most selfhosted S3 servers need path-style URLs, so leave this on if you're unsure. - Enter your Access key ID and Secret access key.
- If you’d like to encrypt your data before storing it in your bucket, you can set a passphrase here. If you don’t enter anything, it won’t be encrypted.
- When you click “Continue”, floccus checks that it can reach your bucket with the details you provided. If this fails, see the troubleshooting tips below.
- Next, you can specify the name of your bookmarks file in the bucket. By default floccus will create a file called bookmarks.xbel in the root of the bucket. You can also put it in a "folder" by entering a path like
personal_stuff/bookmarks.xbel, but don't start or end it with a slash. You can also choose whether the file should be stored in XBEL or HTML format. - Finally, you can choose which bookmarks folder to sync to that file. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus. (This can cause frequent duplication of bookmarks.)
On your other devices, set up a profile with the same endpoint, region, bucket, bookmarks file and passphrase.
While syncing, floccus creates a lock file next to your bookmarks file (e.g. bookmarks.xbel.lock) to prevent two devices from syncing at the same time. It's deleted again when the sync is finished. Make sure that no lifecycle rules delete or archive your bookmarks file, and don't enable object lock for the bucket, as floccus needs to be able to overwrite and delete its files.
Troubleshooting
- The bucket does not exist: Check the bucket name, the endpoint URL and the region. Also make sure the endpoint URL doesn't contain the bucket name already. If you're using a selfhosted server, try turning on path-style URLs.
- Authentication failed: Check your access key ID and secret access key and make sure the key is allowed to access the bucket.
- The bucket is located in a different region: Floccus will tell you which region the bucket is in. Enter that region and try again.
- Network error: Check that the endpoint URL is correct and reachable from your device. If you're using a selfhosted server with a self-signed certificate, your browser or phone needs to trust that certificate.
- Create a new profile in the Floccus panel
- Select Git over HTTPS as your sync method
- The following screens show the profile settings.
- First you will need to enter your Git repository URL and a branch to sync to. Make sure to use the HTTPS URL instead of the SSH URL if you have the choice. Also, make sure that the branch already exists and there are no branch rules that prevent direct commits to the branch.
- Then enter your username and password for your Git hosting provider. Note that it is recommended that you use a device token with read/write access to Content here instead of your actual password and may be a requirement, particularly if you have 2-factor authentication enabled for your account.
- You can then enter a path and filename for the bookmarks file inside your Git repository. All folders in the path must already exist in the repository. The easiest is to just store it in the root.
- Finally, you can choose which bookmarks folder to sync to that file. Click on the folder icon to select a folder in your bookmarks. You will need to pick a folder before you can continue, and it’s a good idea to choose a dedicated folder to avoid syncing something that you don’t want synced.
- Make sure to disable your native browser bookmark sync service, because it is likely incompatible with floccus
Advanced
Floccus supports unidirectional, one-way sync as well two-directional “merge” sync.
Merge
Set floccus' Sync strategy to 'Always merge local changes with changes from other browsers'.
In merge mode, changes from your local browser are merged with changes from other browsers.
One-way sync
Set floccus' Sync strategy to 'Always undo local changes and download changes from other browsers' or 'Always upload local changes and undo changes from other browsers'.
Sometimes you want to have one device as a main device and other devices only as listeners. For this scenario you can set the main device to 'Always upload local changes and undo changes from other browsers' and all others to 'Always undo local changes and download changes from other browsers' to override their changes with the changes from the main device.
Temporary one-way
Occasionally you only want to temporarily override changes from other devices. For this you can use 'Push up once' in the floccus dropdown.
In order to undo local changes you can use 'Pull down once' in the floccus dropdown to revert all your local changes with the latest server state.
Only notify me about changes
Enable 'Only notify me about changes' in the sync behavior settings of your profile.
If you'd rather decide yourself when to sync, you can let floccus only tell you about changes. The usual triggers (changes to your local bookmarks, browser startup and the sync interval) will then only check whether there is anything to sync, instead of syncing right away.
When there are changes waiting, the profile shows "Needs sync" along with how many changes are waiting to come from the server and to go to the server, and the floccus icon gets a yellow exclamation mark badge. You can then start the sync from the floccus panel whenever it suits you. If you also enable 'Show a notification', floccus will show a system notification when the profile has changes to sync. Your browser will ask you for permission to show notifications the first time you enable this.
This option is available in the browser extension for all sync methods, but not in the floccus app for Android and iOS.
Instead of syncing a local bookmarks folder, Floccus can optionally sync your open browser tabs.
- Create a new profile with the sync method of your choice
- In the profile settings, select Tabs instead of a local folder to sync
By default, floccus' sync strategy is set to "Always merge local changes with changes from other browsers". This feature is still slightly experimental as it sometimes causes tabs to duplicate. Changing the strategy may alleviate these issues, as shown below.
Auto-push
You can enable Auto-sync but set sync strategy to "Always upload local changes and undo changes from other browsers". This will automatically push your currently open tabs to the server. Whenever you need the tabs on a different browser, or after a crash, you can click "Pull down once" to get the tabs back.
Manual up- and download
Auto-push can sometimes cause surprises when you have it enabled on multiple devices or when an empty session is pushed after a browser crash, overriding the previously stored session. This is why you can also turn off auto-sync and push and pull your tabs manually, i.e. when you want to switch to a different device upload your open tabs once on device A and download once on device B – et voila, all your tabs are now on the new device.
Mixing tabs and bookmarks
You can use a subpath on your server to manage tabs, while syncing the root path to your browser bookmarks. This will make available your tabs as bookmarks as well.
Note however, that, depending on which server you use, this can cause issues. Some of these are:
- Sites that you open without explicitly bookmarking them will automatically appear as bookmarked after some seconds, because the tabs are synced to your bookmarks automatically. This may not be ideal, because you don't know if the site is actually bookmarked or just in your synced tabs.
- Nextcloud Bookmarks will show sites that you have in your tabs but that are also bookmarked as duplicates
In order to sync bookmarks between multiple browsers with floccus you need to set up the same profile on each browser that you want to sync. You can do this manually, but this can get tedious. In order to ease the setup process you can export all profiles that you've set up on one browser as a JSON file and import this file on all the other browsers to quickly recreate the same profiles there.
After importing new profiles you will need to pick the local folder to sync again in the profile settings, because bookmark folders cannot be identified across devices. All other profile settings are carried over.
Profiles syncing via Google Drive or Dropbox will additionally ask you to log in again, as these logins cannot be transferred between devices.
Make sure to treat the exported JSON file with utmost security, as it contains the passwords and access tokens for the servers you configured.
Do not confuse this feature with bookmarks sync. Floccus syncs your bookmarks automatically, no manual import or export needed, this is only for profiles to ease the process of setting up floccus on all your devices.
Still stuck? Check the FAQ or get support.
How does floccus deal with your personal data? Privacy policy · License