From 0ffb30d5f8b0bf541e0dcd598e7cc3a6faa11ee0 Mon Sep 17 00:00:00 2001 From: Dan Brown Date: Sat, 8 Apr 2023 22:23:46 +0100 Subject: [PATCH] Added path mapping section to readme Closes linuxserver/docker-bookstack#167 --- readme-vars.yml | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/readme-vars.yml b/readme-vars.yml index 8ee1b6b..0b8d875 100644 --- a/readme-vars.yml +++ b/readme-vars.yml @@ -87,9 +87,22 @@ app_setup_block: | This application is dependent on a MySQL database be it one you already have or a new one. If you do not already have one, set up our MariaDB container here https://hub.docker.com/r/linuxserver/mariadb/. - If you intend to use this application behind a subfolder reverse proxy, such as our SWAG container or Traefik you will need to make sure that the `APP_URL` environment variable is set to your external domain, or it will not work + If you intend to use this application behind a subfolder reverse proxy, such as our SWAG container or Traefik you will need to make sure that the `APP_URL` environment variable is set to your external domain, or it will not work. - Documentation for BookStack can be found at https://www.bookstackapp.com/docs/ + Documentation for BookStack can be found at https://www.bookstackapp.com/docs/. + + ### BookStack File & Directory Paths + This container ensures certain BookStack application files & folders, such as user file upload folders, are retained within the `/config` folder so that they are persistent & accessible when the `/config` container path is bound as a volume. There may be cases, when following the BookStack documentation, that you'll need to know how these files and folders are used relative to a non-container BookStack installation. + + Below is a mapping of container `/config` paths to those relative within a BookStack install directory: + + - **/config container path** => **BookStack relative path** + - `/config/www/.env` => `.env` + - `/config/www/laravel.log` => `storage/logs/laravel.log` + - `/config/www/files/` => `storage/uploads/files/` + - `/config/www/images/` => `storage/uploads/images/` + - `/config/www/themes/` => `themes/` + - `/config/www/uploads/` => `public/uploads/` ### Advanced Users (full control over the .env file) If you wish to use the extra functionality of BookStack such as email, Memcache, LDAP and so on you will need to make your own .env file with guidance from the BookStack documentation.