Interesting Take On A Wiki - Testing Now

JaredBusch

Those instructions are also using Nginx as the web server. I typically default to using Apache in my guides.

scottalanmiller

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

@scottalanmiller said in Interesting Take On A Wiki - Testing Now:

@nashbrydges said in Interesting Take On A Wiki - Testing Now:

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

https://deviantengineer.com/2017/02/bookstack-centos7/

I'm testing this install next...just for fun.

Stick to Fedora, half that install is just getting CentOS to the point where it will work like Fedora. Just start with Fedora and integrated management of those pieces. That totally defeats the point of CentOS to use it in that way.

When I saw the need of epel and IUS repo automatically tells me to use Fedora instead.

Exactly. I'm okay with the EPEL for minor packages that are not includes, like fail2ban, but not as a means to getting different package versions. So generally EPEL I'm cool with, but IUS I am not. Not that it is bad, it just means you intended to use Fedora and made a mistake.

scottalanmiller

@jaredbusch said in Interesting Take On A Wiki - Testing Now:

Those instructions are also using Nginx as the web server. I typically default to using Apache in my guides.

Same here, NGinx for RP, Apache for PHP app server.

JaredBusch

Also, I will be making a guide in a bit as this looks like an interesting project to test.

black3dynamite

I do like how wiki.js can use a git repo for version control and backup. Is there a way to do the same with bookstack?

scottalanmiller

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

I do like how wiki.js can use a git repo for version control and backup. Is there a way to do the same with bookstack?

It mentioned GIT in the reqs, so I am guessing yes.

DokuWiki you can easily as well.

JaredBusch

@scottalanmiller said in Interesting Take On A Wiki - Testing Now:

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

I do like how wiki.js can use a git repo for version control and backup. Is there a way to do the same with bookstack?

It mentioned GIT in the reqs, so I am guessing yes.

DokuWiki you can easily as well.

It uses git to clone the install. so no. not backing to git.

JaredBusch

The install guide says that you need to create some rewrite rules if not using Apache or have .htaccess disabled. So this means they default to Apache.

Yet the Ubuntu install script installs Nginx.

https://www.bookstackapp.com/docs/admin/installation/

And that community guide for CentOS 7 also installs Nginx. I wonder which they intend to be used.

JaredBusch

@scottalanmiller said in Interesting Take On A Wiki - Testing Now:

@nashbrydges said in Interesting Take On A Wiki - Testing Now:

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

https://deviantengineer.com/2017/02/bookstack-centos7/

I'm testing this install next...just for fun.

Stick to Fedora, half that install is just getting CentOS to the point where it will work like Fedora. Just start with Fedora and integrated management of those pieces. That totally defeats the point of CentOS to use it in that way.

Also this was on that page... just no...
0_1518989699403_def0da61-a2cc-4e9a-a70e-f5aaa8fc9d96-image.png

stacksofplates

Also, you don't need IUS for any of that. It's all in the CentOS SCL repos.

Also as @JaredBusch mentioned disabling the firewall and SELinux, and he's a "Sr. Security Engineer"...................

JaredBusch

okay, this thing just sucks donkey balls. I spent way the fuck too much time on this and still not working.

Assuming Fedora 27 Minimal

# required packages + nano 
dnf install -y composer git mariadb mariadb-server mcrypt nano php php-cli php-curl php-fpm php-gd php-json php-mbstring php-mysqlnd php-openssl php-pdo php-tidy php-tokenizer php-xml php-zip policycoreutils policycoreutils-python policycoreutils-python-utils
#open HTTP
firewall-cmd --zone=public --add-port=http/tcp --permanent
firewall-cmd --reload
#start and enable mariadb
systemctl start mariadb
systemctl enable mariadb
#start and enable apache
systemctl start httpd
systemctl enable httpd
# Create Database and user with a random password for Bookstack
export DB_PASS="$(head /dev/urandom | tr -dc A-Za-z0-9 | head -c 13)"
echo DB_PASS=$DB_PASS
mysql -e "CREATE DATABASE bookstack;"
mysql -e "CREATE USER 'bookstack'@'localhost' IDENTIFIED BY '$DB_PASS';"
mysql -e "GRANT ALL ON bookstack.* TO 'bookstack'@'localhost';"
mysql -e "FLUSH PRIVILEGES;"
# Secure MariaDB
###################################################
##############CHANGE THE PASSWORD##################
mysql -e "UPDATE mysql.user SET Password=PASSWORD('somesecurepassword') WHERE User='root';"
mysql -e "DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost', '127.0.0.1', '::1');"
mysql -e "DELETE FROM mysql.user WHERE User='';"
mysql -e "DROP DATABASE test;"
mysql -e "FLUSH PRIVILEGES;"
# Download BookStack
cd /var/www/html/
git clone https://github.com/ssddanbrown/BookStack.git --branch release --single-branch bookstack
export DIR_BOOKSTACK="/var/www/html/bookstack"
# Install BookStack composer dependancies
cd $DIR_BOOKSTACK
composer install
# Copy and update BookStack environment variables
cp $DIR_BOOKSTACK/.env.example $DIR_BOOKSTACK/.env
sed -i 's/DB_DATABASE=.*$/DB_DATABASE=bookstack/' $DIR_BOOKSTACK/.env
sed -i 's/DB_USERNAME=.*$/DB_USERNAME=bookstack/' $DIR_BOOKSTACK/.env
sed -i "s/DB_PASSWORD=.*\$/DB_PASSWORD=$DB_PASS/" $DIR_BOOKSTACK/.env
# update the apache DocumentRoot
sed -i 's/DocumentRoot "\/var\/www\/html"/DocumentRoot "\/var\/www\/html\/bookstack\/public"/' /etc/httpd/conf/httpd.conf
#setup SELinux permissions
export httpdrw='httpd_sys_rw_content_t'
setsebool -P httpd_can_sendmail 1
setsebool -P httpd_can_network_connect 1
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/storage(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/storage
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/bootstrap/cache(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/bootstrap/cache
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/public/uploads(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/public/uploads
#setup ownership of the bookstrap directory to apache
chown apache:apache -R $DIR_BOOKSTACK
# Generate the application key
php artisan key:generate --no-interaction --force
# Migrate the databases
php artisan migrate --no-interaction --force
#Restart httpd
systemctl restart httpd

Browse to the IP http://yourip and get redirected to http://yourip/login so that application is running.
If I set the APP_URL in the .env file, browsing to http://yourip will redirect to the http://FQDN/login. So yet more proof that the application if running.

But I see this.
0_1519022950755_a1994cee-1700-490a-9a22-9fc36b66983b-image.png

JaredBusch

I seutp the docker image to demo things a bit and I like it. The WYSIWYG works well. I copy/pasted a web page into the editor and it kept everything.

Did not test copy/pasting a Word document.
0_1519023151296_2aa8fa98-fc24-4973-ba8e-199ea3d7299a-image.png

Pages also have tags if you want.
0_1519023174550_ad3ca415-ea79-4a5a-b2fd-8ed126adf2df-image.png

And you can upload files to attach to a page.
0_1519023198641_2c807360-983d-4945-bbf9-541b8a6794ef-image.png

black3dynamite

@jaredbusch said in Interesting Take On A Wiki - Testing Now:

okay, this thing just sucks donkey balls. I spent way the fuck too much time on this and still not working.

Assuming Fedora 27 Minimal

# required packages + nano 
dnf install -y composer git mariadb mariadb-server mcrypt nano php php-cli php-curl php-fpm php-gd php-json php-mbstring php-mysqlnd php-openssl php-pdo php-tidy php-tokenizer php-xml php-zip policycoreutils policycoreutils-python policycoreutils-python-utils
#open HTTP
firewall-cmd --zone=public --add-port=http/tcp --permanent
firewall-cmd --reload
#start and enable mariadb
systemctl start mariadb
systemctl enable mariadb
#start and enable apache
systemctl start httpd
systemctl enable httpd
# Create Database and user with a random password for Bookstack
export DB_PASS="$(head /dev/urandom | tr -dc A-Za-z0-9 | head -c 13)"
echo DB_PASS=$DB_PASS
mysql -e "CREATE DATABASE bookstack;"
mysql -e "CREATE USER 'bookstack'@'localhost' IDENTIFIED BY '$DB_PASS';"
mysql -e "GRANT ALL ON bookstack.* TO 'bookstack'@'localhost';"
mysql -e "FLUSH PRIVILEGES;"
# Secure MariaDB
###################################################
##############CHANGE THE PASSWORD##################
mysql -e "UPDATE mysql.user SET Password=PASSWORD('somesecurepassword') WHERE User='root';"
mysql -e "DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost', '127.0.0.1', '::1');"
mysql -e "DELETE FROM mysql.user WHERE User='';"
mysql -e "DROP DATABASE test;"
mysql -e "FLUSH PRIVILEGES;"
# Download BookStack
cd /var/www/html/
git clone https://github.com/ssddanbrown/BookStack.git --branch release --single-branch bookstack
export DIR_BOOKSTACK="/var/www/html/bookstack"
# Install BookStack composer dependancies
cd $DIR_BOOKSTACK
composer install
# Copy and update BookStack environment variables
cp $DIR_BOOKSTACK/.env.example $DIR_BOOKSTACK/.env
sed -i 's/DB_DATABASE=.*$/DB_DATABASE=bookstack/' $DIR_BOOKSTACK/.env
sed -i 's/DB_USERNAME=.*$/DB_USERNAME=bookstack/' $DIR_BOOKSTACK/.env
sed -i "s/DB_PASSWORD=.*\$/DB_PASSWORD=$DB_PASS/" $DIR_BOOKSTACK/.env
# update the apache DocumentRoot
sed -i 's/DocumentRoot "\/var\/www\/html"/DocumentRoot "\/var\/www\/html\/bookstack\/public"/' /etc/httpd/conf/httpd.conf
#setup SELinux permissions
export httpdrw='httpd_sys_rw_content_t'
setsebool -P httpd_can_sendmail 1
setsebool -P httpd_can_network_connect 1
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/storage(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/storage
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/bootstrap/cache(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/bootstrap/cache
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/public/uploads(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/public/uploads
#setup ownership of the bookstrap directory to apache
chown apache:apache -R $DIR_BOOKSTACK
# Generate the application key
php artisan key:generate --no-interaction --force
# Migrate the databases
php artisan migrate --no-interaction --force
#Restart httpd
systemctl restart httpd

Browse to the IP http://yourip and get redirected to http://yourip/login so that application is running.
If I set the APP_URL in the .env file, browsing to http://yourip will redirect to the http://FQDN/login. So yet more proof that the application if running.

But I see this.
0_1519022950755_a1994cee-1700-490a-9a22-9fc36b66983b-image.png

I followed your guide except I created a conf file in /etc/httpd/conf.d/wiki.example.com.conf

sudo tee /etc/httpd/conf.d/wiki.example.com.conf <<EOF
<VirtualHost *:80>
    ServerAdmin webmaster@localhost
      <Directory /var/www/html/bookstack/public>
        Require all granted
        AllowOverride All
        #Options +Indexes
      </Directory>
    DocumentRoot /var/www/html/bookstack/public
    ServerName wiki.example.com
    ErrorLog /var/log/httpd/bookstack.error.log
    CustomLog /var/log/httpd/access.log combined
</VirtualHost>
EOF

I pretty much did they same setup like Snipe-IT.

And my APP_URL is APP_URL=https://wiki.example.com

NashBrydges

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

<VirtualHost *:80>
ServerAdmin webmaster@localhost
<Directory /var/www/html/bookstack/public>
Require all granted
AllowOverride All
#Options +Indexes
</Directory>
DocumentRoot /var/www/html/bookstack/public
ServerName wiki.example.com
ErrorLog /var/log/httpd/bookstack.error.log
CustomLog /var/log/access.log combined
</VirtualHost>

This combined setup worked perfectly!

NashBrydges

This looks like it could work for multi-tenant environment.

Created a new role and granted no permissions whatsoever.
Created a new book with a sample page within the book
Clicked on "More" at top right and assigned View only privileges to this new role I created
Created new user and assigned user to new role
Logged in as new user and all I can see is the test book to which I granted permissions. I also can't create any new material because those permissions weren't granted. When I search for a document that was created in the Admin role, I cannot see any search results that I know exist under the Admin role but that haven't been granted access to on this restricted user role. All I can see as this restricted user is the single book that I've granted View access to.
The book permissions also cascade to other pages created in the same book so once permissions are set at the book, the are also set for child sections.

NashBrydges

One awesome function is the Export capability. If I export a book to a PDF, all subsequent Chapters and Pages are also exported. It creates an index page linked to the child sections allowing navigation to the child sections within the PDF file.

JaredBusch

@nashbrydges said in Interesting Take On A Wiki - Testing Now:

One awesome function is the Export capability. If I export a book to a PDF, all subsequent Chapters and Pages are also exported. It creates an index page linked to the child sections allowing navigation to the child sections within the PDF file.

If you are going to export to PDF a lot, there is another package you need to install

https://www.bookstackapp.com/docs/admin/pdf-rendering/

JaredBusch

@black3dynamite said in Interesting Take On A Wiki - Testing Now:

@jaredbusch said in Interesting Take On A Wiki - Testing Now:

okay, this thing just sucks donkey balls. I spent way the fuck too much time on this and still not working.

Assuming Fedora 27 Minimal

# required packages + nano 
dnf install -y composer git mariadb mariadb-server mcrypt nano php php-cli php-curl php-fpm php-gd php-json php-mbstring php-mysqlnd php-openssl php-pdo php-tidy php-tokenizer php-xml php-zip policycoreutils policycoreutils-python policycoreutils-python-utils
#open HTTP
firewall-cmd --zone=public --add-port=http/tcp --permanent
firewall-cmd --reload
#start and enable mariadb
systemctl start mariadb
systemctl enable mariadb
#start and enable apache
systemctl start httpd
systemctl enable httpd
# Create Database and user with a random password for Bookstack
export DB_PASS="$(head /dev/urandom | tr -dc A-Za-z0-9 | head -c 13)"
echo DB_PASS=$DB_PASS
mysql -e "CREATE DATABASE bookstack;"
mysql -e "CREATE USER 'bookstack'@'localhost' IDENTIFIED BY '$DB_PASS';"
mysql -e "GRANT ALL ON bookstack.* TO 'bookstack'@'localhost';"
mysql -e "FLUSH PRIVILEGES;"
# Secure MariaDB
###################################################
##############CHANGE THE PASSWORD##################
mysql -e "UPDATE mysql.user SET Password=PASSWORD('somesecurepassword') WHERE User='root';"
mysql -e "DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost', '127.0.0.1', '::1');"
mysql -e "DELETE FROM mysql.user WHERE User='';"
mysql -e "DROP DATABASE test;"
mysql -e "FLUSH PRIVILEGES;"
# Download BookStack
cd /var/www/html/
git clone https://github.com/ssddanbrown/BookStack.git --branch release --single-branch bookstack
export DIR_BOOKSTACK="/var/www/html/bookstack"
# Install BookStack composer dependancies
cd $DIR_BOOKSTACK
composer install
# Copy and update BookStack environment variables
cp $DIR_BOOKSTACK/.env.example $DIR_BOOKSTACK/.env
sed -i 's/DB_DATABASE=.*$/DB_DATABASE=bookstack/' $DIR_BOOKSTACK/.env
sed -i 's/DB_USERNAME=.*$/DB_USERNAME=bookstack/' $DIR_BOOKSTACK/.env
sed -i "s/DB_PASSWORD=.*\$/DB_PASSWORD=$DB_PASS/" $DIR_BOOKSTACK/.env
# update the apache DocumentRoot
sed -i 's/DocumentRoot "\/var\/www\/html"/DocumentRoot "\/var\/www\/html\/bookstack\/public"/' /etc/httpd/conf/httpd.conf
#setup SELinux permissions
export httpdrw='httpd_sys_rw_content_t'
setsebool -P httpd_can_sendmail 1
setsebool -P httpd_can_network_connect 1
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/storage(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/storage
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/bootstrap/cache(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/bootstrap/cache
semanage fcontext -a -t ${httpdrw} "${DIR_BOOKSTACK}/public/uploads(/.*)?"
restorecon -R -F ${DIR_BOOKSTACK}/public/uploads
#setup ownership of the bookstrap directory to apache
chown apache:apache -R $DIR_BOOKSTACK
# Generate the application key
php artisan key:generate --no-interaction --force
# Migrate the databases
php artisan migrate --no-interaction --force
#Restart httpd
systemctl restart httpd

Browse to the IP http://yourip and get redirected to http://yourip/login so that application is running.
If I set the APP_URL in the .env file, browsing to http://yourip will redirect to the http://FQDN/login. So yet more proof that the application if running.

But I see this.
0_1519022950755_a1994cee-1700-490a-9a22-9fc36b66983b-image.png

I followed your guide except I created a conf file in /etc/httpd/conf.d/wiki.example.com.conf

sudo tee /etc/httpd/conf.d/wiki.example.com.conf <<EOF
<VirtualHost *:80>
    ServerAdmin webmaster@localhost
      <Directory /var/www/html/bookstack/public>
        Require all granted
        AllowOverride All
        #Options +Indexes
      </Directory>
    DocumentRoot /var/www/html/bookstack/public
    ServerName wiki.example.com
    ErrorLog /var/log/httpd/bookstack.error.log
    CustomLog /var/log/access.log combined
</VirtualHost>
EOF

I pretty much did they same setup like Snipe-IT.

And my APP_URL is APP_URL=https://wiki.example.com

Ok, added the vhost config, removed the change to the httpd.conf, and it works

I added one yesterday also, but I must not have got all the options right.

NashBrydges

@jaredbusch said in Interesting Take On A Wiki - Testing Now:

@nashbrydges said in Interesting Take On A Wiki - Testing Now:

One awesome function is the Export capability. If I export a book to a PDF, all subsequent Chapters and Pages are also exported. It creates an index page linked to the child sections allowing navigation to the child sections within the PDF file.

If you are going to export to PDF a lot, there is another package you need to install

https://www.bookstackapp.com/docs/admin/pdf-rendering/

Thanks for this.

black3dynamite

@nashbrydges said in Interesting Take On A Wiki - Testing Now:

This looks like it could work for multi-tenant environment.

Created a new role and granted no permissions whatsoever.

Created a new book with a sample page within the book

Clicked on "More" at top right and assigned View only privileges to this new role I created

Created new user and assigned user to new role

Logged in as new user and all I can see is the test book to which I granted permissions. I also can't create any new material because those permissions weren't granted. When I search for a document that was created in the Admin role, I cannot see any search results that I know exist under the Admin role but that haven't been granted access to on this restricted user role. All I can see as this restricted user is the single book that I've granted View access to.

The book permissions also cascade to other pages created in the same book so once permissions are set at the book, the are also set for child sections.

That works well.