Cómo instalar BookStack en Ubuntu 18.04 LTS

Página de inicio de sesión de la pila de libros

BookStack es una plataforma de gesti√≥n del conocimiento gratuita y de c√≥digo abierto que se puede utilizar para crear documentaci√≥n y contenido de wikis para sus usuarios. BookStack est√° escrito en lenguaje PHP y utiliza el marco web Laravel. BookStack le permite configurar BookStack seg√ļn sus necesidades, como cambiar el nombre, el logotipo y las opciones de registro. BookStack ofrece muchas funciones, como compatibilidad con varios idiomas, editor de Markdown, personalizable, con capacidad de b√ļsqueda, interfaz WYSIWYG, gesti√≥n de roles y permisos, autenticaci√≥n integrada y muchas m√°s.

En este tutorial, aprenderemos cómo instalar Bookstack con Apache en el servidor Ubuntu 18.04.

Requisitos

  • Un servidor con Ubuntu 18.04.
  • Un usuario no root con privilegios sudo.

Empezando

Antes de comenzar, deber√° actualizar su sistema con la √ļltima versi√≥n. Puede hacer esto ejecutando el siguiente comando:

sudo apt-get update -y
sudo apt-get upgrade -y

Una vez que su sistema esté actualizado, reinicie el sistema para aplicar los cambios.

Instalar servidor LAMP

Primero, deberá instalar el servidor web Apache, el servidor MariaDB, PHP y otros módulos PHP en su sistema. Puede instalarlos todos ejecutando el siguiente comando:

sudo apt-get install apache2 mariadb-server php7.2 libapache2-mod-php7.2 php7.2-common php7.2-sqlite3 php7.2-curl php7.2-intl php7.2-mbstring php7.2-xmlrpc php7.2-mysql php7.2-gd php7.2-xml php7.2-cli php7.2-tidy php7.2-zip unzip wget git -y

Una vez que todos los paquetes estén instalados, abra el archivo php.ini y realice algunos cambios:

sudo nano /etc/php/7.2/apache2/php.ini

Realice los siguientes cambios:

memory_limit = 256M
upload_max_filesize = 150M
max_execution_time = 360
date.timezone = Asia/Kolakata

Guarde y cierre el archivo.

Configurar MariaDB

De forma predeterminada, MariaDB no est√° protegido. Por lo tanto, deber√° asegurarlo primero. Puede asegurarlo ejecutando el siguiente comando:

sudo mysql_secure_installation

Responda todas las preguntas de la siguiente manera:

    Enter current password for root (enter for none): ENTER
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Una vez que MariaDB esté protegida, inicie sesión en el shell de MariaDB:

mysql -u root -p

Proporcione su contrase√Īa ra√≠z. Luego, crea una base de datos y un usuario para Bookstack:

MariaDB [(none)]> CREATE DATABASE bookstackdb;
MariaDB [(none)]> CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'password';

Reemplace la palabra ‘contrase√Īa’ en el comando anterior con una contrase√Īa segura y no la baje para su uso posterior. A continuaci√≥n, otorgue todos los privilegios a Bookstack con el siguiente comando:

MariaDB [(none)]> GRANT ALL ON bookstackdb.* TO 'bookstack'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Reemplace la palabra ‘contrase√Īa’ nuevamente aqu√≠ con la misma contrase√Īa que us√≥ anteriormente. A continuaci√≥n, elimine los privilegios y salga del shell de MariaDB:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Instalar la pila de libros

Primero, deber√° instalar Composer en su sistema. Composer es un administrador de dependencias para PHP. Puede instalar Composer con el siguiente comando:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

A continuaci√≥n, cambie el directorio a /var/www/html y descargue la √ļltima versi√≥n de Bookstack desde el repositorio de Git con el siguiente comando:

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

A continuación, cambie el directorio a Bookstack e instale todas las dependencias requeridas por PHP con el siguiente comando:

cd Bookstack
sudo composer install

Una vez que todas las dependencias estén instaladas, copie el archivo de configuración del entorno de muestra con el siguiente comando:

sudo cp .env.example .env

A continuación, actualice la configuración de la base de datos en el archivo .env:

sudo nano .env

Realice los siguientes cambios:

# Database details
DB_HOST=localhost
DB_DATABASE=bookstackdb
DB_USERNAME=bookstack
DB_PASSWORD=password

Guarde y cierre el archivo. Luego, cree la clave de la aplicación y migre la base de datos con el siguiente comando:

sudo php artisan key:generate

Producción:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Application key [base64:KTcNpGD5CacIz20eiKpusk02YaHm14OQTZTERizEDBw=] set successfully.

A continuación, deberá migrar la base de datos. Puede migrar la base de datos con el siguiente comando:

sudo php artisan migrate

Debería ver el siguiente resultado:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Migration table created successfully.

A continuación, otorgue los permisos adecuados al directorio Bookstack con el siguiente comando:

sudo chown -R www-data:www-data /var/www/html/BookStack/
sudo chmod -R 755 /var/www/html/BookStack/

Configurar Apache para Bookstack

A continuación, deberá crear un archivo de host virtual de Apache para Bookstack. Puedes crearlo con el siguiente comando:

sudo nano /etc/apache2/sites-available/bookstack.conf

Agregue las siguientes líneas:

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/Bookstack
     ServerName example.com
     ServerAlias www.example.com

    <Directory /var/www/html/Bookstack/>
        Options FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Reemplace ‘example.com’ y ‘www.example.com’ en el archivo anterior con su propio nombre de dominio. Luego guarde y cierre el archivo y habilite el archivo de host virtual de Apache y reescriba el m√≥dulo con los siguientes comandos:

sudo a2ensite bookstack.conf
sudo a2enmod rewrite

Finalmente, reinicie el servicio web de Apache para aplicar todos los cambios:

sudo systemctl restart apache2

Acceder a la pila de libros

Abra su navegador web y escriba la URL, en mi caso es http://example.com, ser√° redirigido a la siguiente p√°gina:

Página de inicio de sesión de la pila de libros

Ahora, proporcione el nombre de usuario predeterminado como [email¬†protected] y clave como contrase√Īa, luego haga clic en el INICIAR SESI√ďN bot√≥n. Se le redirigir√° al panel de control de Bookstack en la siguiente p√°gina:

Iniciar sesi√≥n con nombre de usuario y contrase√Īa predeterminados

El siguiente paso debe ser cambiar la contrase√Īa predeterminada para asegurar el inicio de sesi√≥n de BookStack.

Conclusión

¬°Felicidades! ha instalado exitosamente Bookstack en el servidor Ubuntu 18.04 LTS. Ahora puede crear f√°cilmente su propio sitio wiki usando Bookstack. No dude en preguntarme si tiene alguna pregunta.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *