Install BookStack - Documentation/Wiki Platform - on Windows
15#BookStack #Wiki #Windows
Full steps can be found at https://i12bretro.github.io/tutorials...
What is BookStack?
BookStack is an opinionated wiki system that provides a pleasant and simple out-of-the-box experience. New users to an instance should find the experience intuitive and only basic word-processing skills should be required to get involved in creating content on BookStack. The platform should provide advanced power features to those that desire it but they should not interfere with the core simple user experience. - https://github.com/BookStackApp/BookS...
Installation
01. Download XAMPP https://sourceforge.net/projects/xamp...
02. Download BookStack https://github.com/BookStackApp/BookS...
03. Download Microsoft Visual C++ https://aka.ms/vs/16/release/vc_redis...
04. Download Composer https://getcomposer.org/Composer-Setu...
05. Install Microsoft Visual C++
06. Right click the downloaded XAMPP .zip file ≫ Extract All...
07. Right click the downloaded BookStack .zip file ≫ Extract All...
08. Rename the extracted folder bookstack
09. Cut the bookstack folder inside the XAMPP directory
10. Copy the extracted XAMPP directory to a safe location to run from, C:\Program Files for example
11. Run XAMPP/setup_xampp.bat to update the configuration files with the new server location
Configuring the Web Server
01. Navigate to XAMPP/php and edit php.ini
02. Find the following line and remove the ; to uncomment them
extension=ldap
extension=gd
03. Save the changes to php.ini
04. Navigate to XAMPP/apache/conf and edit httpd.conf
05. Paste the following configuration at the bottom of the file, update the folder paths as needed
Alias /bookstack "C:/Program Files/xampp/bookstack/public/"
≪Directory "C:/Program Files/xampp/bookstack/public/"≫
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
≪IfModule mod_rewrite.c≫
≪IfModule mod_negotiation.c≫
Options -MultiViews -Indexes
≪/IfModule≫
RewriteEngine On
Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
Redirect Trailing Slashes If Not A Folder...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} (.+)/$
RewriteRule ^ %1 [L,R=301]
Handle Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
≪/IfModule≫
≪/Directory≫
06. Save the changes to httpd.conf
07. Install Composer
08. Run XAMPP/xampp-control.exe
09. Click the Start button next to Apache and MySQL
10. Navigate to XAMPP/mysql/bin
11. Hold the SHIFT key and right click in the white space ≫ Open PowerShell window here...
12. Type the following in the PowerShell window to setup the BookStack database
.\mysql -u root
CREATE DATABASE bookstack;
GRANT ALL ON bookstack.* to 'bookstack_rw'@'localhost' IDENTIFIED BY 'B00k$t@ck!';
FLUSH PRIVILEGES;
EXIT;
exit
13. Navigate to the XAMPP/bookstack folder ≫ Right click in the white space ≫ Open PowerShell window here...
14. Run the following command to download dependencies
create a copy of the sample .env file
cp .\.env.example .\.env
edit .env in notepad
notepad .\.env
15. Modifying the following key/value pairs in .env as needed
APP_ENV=production
APP_DEBUG=false
APP_KEY=SomethingSecure
APP_URL=http://windows11.local/bookstack
APP_TIMEZONE='America/New_York'
APP_LOCALE=en
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=bookstack
DB_USERNAME=bookstack_rw
DB_PASSWORD=B00k$t@ck!
MAIL_DRIVER=smtp
MAIL_HOST=smtp.i12bretro.local
MAIL_PORT=25
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDR=bookstack@i12bretro.local
MAIL_FROM_NAME='BookStack'
MAIL_REPLYTO_ADDR=bookstack@i12bretro.local
MAIL_REPLYTO_NAME='BookStack'
MAIL_AUTO_EMBED_METHOD='attachment'
16. Save the changes to .env
17. Continue with the following commands in PowerShell
install dependencies with composer
composer install --no-dev --no-plugins
generate app key
php artisan key:generate --no-interaction --force
migrate the database
php artisan migrate --no-interaction --force
....Full steps can be found on GitHub [link at the top]
Connect with me and others ###
★ Discord: / discord
★ Reddit: / i12bretro
★ Twitter: / i12bretro