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:
@scottalanmiller said in Interesting Take On A Wiki - Testing Now:
@nashbrydges said in Interesting Take On A Wiki - Testing Now:
By the way, if someone much smarter than I (uh-hum @scottalanmiller or @JaredBusch or others) is willing to take the time to figure out how to install this on Fedora, I'm willing to give your instructions a try
It has very few requirements, looks like it is roughly the same as a really simple WordPress install...
Yeah, the composer install/setup is what's got me stumped. Never used that before or at least not in my short use of Linux OSs.
Maybe I missed that part, where is the composer install?
You can see it on the sample install script but doesn't mention in the manual install.
https://github.com/BookStackApp/devops/blob/master/scripts/installation-ubuntu-16.04.sh
-
@nashbrydges 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:
By the way, if someone much smarter than I (uh-hum @scottalanmiller or @JaredBusch or others) is willing to take the time to figure out how to install this on Fedora, I'm willing to give your instructions a try
It has very few requirements, looks like it is roughly the same as a really simple WordPress install...
Yeah, the composer install/setup is what's got me stumped. Never used that before or at least not in my short use of Linux OSs.
Canβt be any different compare to how Snipe-IT uses it.
-
@nashbrydges 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:
@scottalanmiller said in Interesting Take On A Wiki - Testing Now:
@nashbrydges said in Interesting Take On A Wiki - Testing Now:
By the way, if someone much smarter than I (uh-hum @scottalanmiller or @JaredBusch or others) is willing to take the time to figure out how to install this on Fedora, I'm willing to give your instructions a try
It has very few requirements, looks like it is roughly the same as a really simple WordPress install...
Yeah, the composer install/setup is what's got me stumped. Never used that before or at least not in my short use of Linux OSs.
Maybe I missed that part, where is the composer install?
You can see it on the sample install script but doesn't mention in the manual install.
https://github.com/BookStackApp/devops/blob/master/scripts/installation-ubuntu-16.04.sh
Might not be needed then, or might be specifically needed for old Ubuntu LTS.
-
-
@black3dynamite said in Interesting Take On A Wiki - Testing Now:
I'm testing this install next...just for fun.
-
@nashbrydges said in Interesting Take On A Wiki - Testing Now:
@black3dynamite said in Interesting Take On A Wiki - Testing Now:
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.
-
@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:
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.
-
Those instructions are also using Nginx as the web server. I typically default to using Apache in my guides.
-
@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:
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.
-
@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.
-
Also, I will be making a guide in a bit as this looks like an interesting project to test.
-
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?
-
@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.
-
@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.
-
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.
-
@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:
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...
-
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"...................
-
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 tohttp://yourip/login
so that application is running.
If I set theAPP_URL
in the.env
file, browsing tohttp://yourip
will redirect to thehttp://FQDN/login
. So yet more proof that the application if running.But I see this.
-
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.
Pages also have tags if you want.
And you can upload files to attach to a page.
-
@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 tohttp://yourip/login
so that application is running.
If I set theAPP_URL
in the.env
file, browsing tohttp://yourip
will redirect to thehttp://FQDN/login
. So yet more proof that the application if running.But I see this.
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