Buku includes a companion Web-application, Bukuserver (it requires additional dependencies; the package should be installed with server extra, i.e. pip install buku[server]).

Check out Bukuserver README file for more information.

Since configuring Bukuserver requires setting up environment variables, and it has no builtin support for switching databases, a runner script was made. (It's quite convenient for managing multiple databases, both for normal use and during development.)

As explained in the README file, you can install it in your PATH to run from command line, or in a shortcut to run from your desktop/applications menu; and settings (both for Bukuserver and the script itself) can be defined in bukuserver.env file within your buku settings folder (incidentally, DB files will be placed there as well):

# ~/.local/share/buku/bukuserver.env or %APPDATA%\Roaming\buku\bukuserver.env
BUKUSERVER='~/Sources/buku/'  # when running from sources (nightly/developer option)
BUKUSERVER_THEME=slate
BUKUSERVER_DISABLE_FAVICON=false
BUKUSERVER_OPEN_IN_NEW_TAB=true

DB selection dialog – shown on startup (unless no DB files were found); initially the previous DB is selected

DB creation dialog – shown if no DB was selected (or none found)

A confirmation dialog is shown if new DB name is taken already

DB name must be a valid filename, sans the .db extension (invalid chars: / on Linux, or any of <>:"/\|?* on Windows)

DB selection prompt in console shell/no-GUI mode (BUKU_NOGUI=y)