Kako namestiti BookStack na Fedora 28

BookStack je preprosta platforma za organiziranje in shranjevanje informacij, ki jo gosti sami. BookStack je popolnoma brezplačen in odprtokoden ter ima licenco MIT. Vir je na voljo na GitHubu . V tej vadnici bomo namestili BookStack na nov primerek Fedora 28 Vultr.

Zahteve

• PHP različica 7.0.0 ali novejša in naslednje razširitve:
  • OpenSSL
  • PDO
  • MBstring
  • Tokenizer
  • GD
  • MySQLND
  • Tidy
  • SimpleXML
  • DOM
• MariaDB
• Git (ni nujno potreben, vendar pomaga upravljati posodobitve)
• Skladatelj

Preden začneš

Preverite različico Fedora.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Ustvarite nov nekorenski uporabniški račun z sudodostopom in preklopite nanj.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

OPOMBA: Zamenjajte johndoez vašim uporabniškim imenom.

Nastavite časovni pas.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Prepričajte se, da je vaš sistem posodobljen.

sudo dnf check-upgrade || sudo dnf upgrade -y

Namestite potrebne pakete.

sudo dnf install -y curl git wget vim unzip bash-completion 

Za preprostost onemogočite SELinux in požarni zid.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Namestite PHP in potrebne razširitve PHP

Namestite PHP in potrebne razširitve PHP.

sudo dnf install -y php-cli php-fpm php-gd php-json php-mbstring php-mcrypt php-mysqlnd php-xmlrpc php-common php-tidy php-ldap php-mcrypt php-xml php-zip

Preverite različico.

php -v

Zaženite in omogočite php-fpm.service.

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

Namestite MariaDB

Namestite MariaDB.

sudo dnf install -y mariadb-server

Preverite različico.

mysql --version

Zaženite in omogočite MariaDB.

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Zaženite mysql_secure installationskript, da izboljšate varnost MariaDB in nastavite geslo uporabnika root.

sudo mysql_secure_installation

Povežite se z lupino MariaDB kot root uporabnik.

mysql -u root -p
# Enter password:

Ustvarite prazno zbirko podatkov MariaDB in uporabnika za BookStack ter si zapomnite poverilnice.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT

Namestite Nginx

Namestite Nginx.

sudo dnf install -y nginx

Preverite različico.

sudo nginx -v

Zaženite in omogočite Nginx.

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Konfigurirajte Nginx za BookStack. Zaženite sudo vim /etc/nginx/conf.d/bookstack.confin dodajte naslednjo konfiguracijo.

server {
  listen 80;
  listen [::]:80;

  server_name example.com;

  root /var/www/bookstack/public;

  index index.php index.html;

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }

  location ~ \.php$ {
    fastcgi_index index.php;
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_pass unix:/run/php-fpm/www.sock;
  }
}

Preizkusite konfiguracijo.

sudo nginx -t

Ponovno naložite Nginx.

sudo systemctl reload nginx.service

Namesti Composer

Namesti Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Preverite različico.

composer --version

Namestite BookStack

Ustvarite korensko mapo dokumenta.

sudo mkdir -p /var/www/bookstack

Spremenite lastništvo /var/www/bookstackimenika v johndoe.

sudo chown -R johndoe:johndoe /var/www/bookstack

Klonirajte vejo izdaje repozitorija BookStack GitHub v korensko mapo dokumenta.

cd /var/www/bookstack
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch .

Zaženite composer installiz /var/www/bookstackimenika.

composer install

Kopirajte .env.exampledatoteko .envin jo napolnite z lastno bazo podatkov in e-poštnimi podatki.

cp .env.example .env

Prepričajte se, da spletni strežnik lahko piše v mape storage, bootstrap/cachein public/uploads.

V korenu aplikacije zaženite, php artisan key:generateda ustvarite edinstven ključ aplikacije.

Zaženite, php artisan migrateda posodobite bazo podatkov.

Spremenite lastništvo /var/www/bookstackimenika v nginx.

sudo chown -R nginx:nginx /var/www/bookstack

Zaženite sudo vim /etc/php-fpm.d/www.confin nastavite uporabnika in skupino na nginx. Na začetku bo nastavljen na apache.

sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx

Znova zaženite php-fpmstoritev.

sudo systemctl restart php-fpm.service

Zdaj se lahko prijavite s privzetimi skrbniškimi podatki admin@admin.comz geslom password. Priporočljivo je, da te podatke spremenite neposredno po prvi prijavi.