BookStack
BookStack is a self-hosted wiki platform that organizes content into shelves, books, chapters, and pages. Here are a few tips and fixes for BookStack pods hosted on PikaPods. The official BookStack docs cover the full feature set.
New to BookStack? Start with our BookStack tutorial.
Edit advanced settings
Section titled “Edit advanced settings”Many BookStack settings are configured via its .env file. To edit this file, find it in /config/www/.env using SFTP. This path already contains a pre-populated settings file. If you can’t see the file, please make sure your FTP client shows hidden files, also known as dotfiles.
Sending emails
Section titled “Sending emails”BookStack doesn’t always require emails, but uses it for select features, like forgotten passwords. Available options can be found here and you can add them to the .env file, as described above. For email providers and the details you need, see our email FAQ.
Failures when uploading images
Section titled “Failures when uploading images”If you see errors when uploading images, check the pod’s Nginx logs for memory errors. They can be found in config/log/nginx/error.log after enabling SFTP. If you see something like PHP Fatal error: Allowed memory size of 134217728 bytes exhausted, it can help to increase the pod’s internal memory limit, which is separate from the pod’s limit.
To do so enable SFTP and add this line at the end of config/php/php-local.ini:
memory_limit = 512MThen restart the pod to apply the new setting.