Skip to main content

Misc Tweaks

Misc Tweaks

Many of the commands and edits in this guide need to be performed as root. Use sudo where indicated or log in as root.

.env Edits

Dark Mode

To enable dark mode by default, add the APP_DEFAULT_DARK_MODE option to the .env file and set it to true

# Use dark mode by default
# Will be overriden by any user/session preference.
APP_DEFAULT_DARK_MODE=true

Default Book, Bookshelf, and Bookshelves View

Set a default format for viewing books and bookshelves. The defaults are set out of the box as follows:

  • Books: grid view (vendor documentation says it is supposed to be list view, but it isn't as of version 23.12.2)
  • Bookshelf: grid
  • Bookshelves: grid

The default behavior can be set explicitly by changing the relevant values in /var/www/bookstack/.env to either list or grid. The following example sets them all to list view.

# Show list views by default
# Books view is of all available books
# Bookshelf view is of all available books in a given bookshelf
# Bookshelves view is of all available bookshelves
APP_VIEWS_BOOKS=list
APP_VIEWS_BOOKSHELVES=list
APP_VIEWS_BOOKSHELF=list
# Show list views by default
# Books view is of all available books
# Bookshelf view is of all available books in a given bookshelf
# Bookshelves view is of all available bookshelves
APP_VIEWS_BOOKS=list
APP_VIEWS_BOOKSHELVES=list
APP_VIEWS_BOOKSHELF=list