jarun / buku

:bookmark: Personal mini-web in text
GNU General Public License v3.0
6.52k stars 294 forks source link

Feature Request: Documentation on how to use buku in docker-compose with multi-device-setup. #725

Open Haui1112 opened 7 months ago

Haui1112 commented 7 months ago

First of all, thank you for making this awesome tool. I have installed both the docker compose and the apt version (one on my home server and one on my laptop, I do have a desktop which I would like to use with this as well).

So far I have used the Firefox auto import. Works very well. But since I dont want to save the sftp login to my server on my laptop, I would need to go over web. The firefox extension which I tried to install (bukobrow) doesnt work. I dont even know if thats an official one.

Since I'm not familiar with the api, how would I sync the devices I have? Example: Laptop server desktop (this way I have two devices plus the backup and can provision a new device with the bookmarks as needed.

Thanks for reading. Have a good one.

LeXofLeviafan commented 7 months ago

Bukubrow is not an official buku extension AFAIK, and it doesn't seem to be actively supported nowadays (I've created 2 pull requests a year ago to fix some discrepancies from Buku, but the repo owner has never even reacted to them :sweat_smile:)

As for it not working – for it to actually be able to access your Buku data, you need to "install" a host program first; it needs to be registered as a browser plugin (i.e. run it manually from its permanent location with one of the --install-* arguments, to create a JSON file containing a path to itself in the settings of your browser).

Note that while it's convenient in a way, actually using it requires the Buku data to be accessible locally (i.e. to be present in your filesystem); so the extension itself won't give you any advantages for the usecase of "accessing your bookmarks remotely".


Buku stores its bookmarks in a buku/bookmarks.db file within user settings (e.g. ~/.local/share/buku/bookmarks.db on Linux). There are ways to access your DB remotely, but all of them have downsides:

I've considered the possibility of implementing support for the latter into Buku itself, but I don't give any guarantees as to if or when it will actually be done.