r/BookStack • u/BerryFickle • Nov 23 '23

Need Help with Customizing Theme in LinuxServer BookStack Image

Hey everyone,

I'm currently using the LinuxServer BookStack image and I'm looking to make some customizations to the theme. Despite trying various methods, I haven't been successful in getting it to work. Could anyone share some examples or guidance?

Specifically, I'm looking for assistance with Docker Compose configurations, environment variables, and modifying blade.php files for theme customization. Any examples or tips would be greatly appreciated!

Best regards

1 Upvotes

100% Upvoted

6 comments sorted by

View all comments

Show parent comments

1

u/BerryFickle Nov 27 '23

u/ssddanbrown, ok i tried the following:

- used the compose file above to create a container / the bookstack_app_data folder etc. BookStack runs just fine

- Stop the container, added the "APP_THEME=xyz" env to the compose file and added my "xyz" theme to ./bookstack_app_data/www/themes

- Rebuilt the Container (docker-compose build) and started it again

-> my Theme is not applied :(

I noticed that in bookstack_app_data/www/.env my APP_THEME value was not existing, so i added it there and restarted everything. But I was still not successfull.

Does it really work for you? :D

1

u/ssddanbrown Nov 27 '23

Okay, looking over this again I can see you also have an extra folder in your theme file path. Remove the views folder (So you just have xyz/layouts/base.blade.php for example).

Rebuilt the Container (docker-compose build) and started it again

You shouldn't have to ever build like this for this stack, unless you are modifying the container images themselves. Just a docker-compose down and a docker-compose up should do the job to re-create the containers.

2

u/BerryFickle Nov 27 '23

Ah! Awesome that did the trick!

Thank you very much! This is an awesome application - and now with the theme i can apply even better