Skip to content

Commit 37fb5b4

Browse files
authored
Merge pull request #168 from ssddanbrown/readme-path-mapping
Added file/folder path mapping to readme
2 parents b84b290 + 0ffb30d commit 37fb5b4

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

readme-vars.yml

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,9 +87,22 @@ app_setup_block: |
8787
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/.
8888
8989
90-
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
90+
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.
9191
92-
Documentation for BookStack can be found at https://www.bookstackapp.com/docs/
92+
Documentation for BookStack can be found at https://www.bookstackapp.com/docs/.
93+
94+
### BookStack File & Directory Paths
95+
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.
96+
97+
Below is a mapping of container `/config` paths to those relative within a BookStack install directory:
98+
99+
- **/config container path** => **BookStack relative path**
100+
- `/config/www/.env` => `.env`
101+
- `/config/www/laravel.log` => `storage/logs/laravel.log`
102+
- `/config/www/files/` => `storage/uploads/files/`
103+
- `/config/www/images/` => `storage/uploads/images/`
104+
- `/config/www/themes/` => `themes/`
105+
- `/config/www/uploads/` => `public/uploads/`
93106
94107
### Advanced Users (full control over the .env file)
95108
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.

0 commit comments

Comments
 (0)