Se você está procurando uma maneira de instalar o BookStack, uma plataforma de documentação open-source, em um servidor VPS com Nginx, siga as etapas abaixo.
Pré-requisitos
- Um servidor VPS rodando Ubuntu 20.04.
- Acesso root ou sudo ao servidor.
- Um domínio apontando para o seu servidor (opcional, mas recomendado).
Passo 1: Atualizar o Sistema
Primeiro, atualize os pacotes do seu sistema:
sudo apt update && sudo apt upgrade -yPasso 2: Instalar Dependências
Instale as dependências necessárias:
sudo apt install apache2
sudo apt install mysql-server
sudo apt install php php-mysql libapache2-mod-php php-cli php-xml php-mbstring php-curl
Passo 3: Instalar o Composer
O BookStack usa o Composer para gerenciar dependências. Instale-o usando os seguintes comandos:
sudo apt install unzip
curl -sS https://getcomposer.org/installer -o composer-setup.php
php -r "if (hash_file('sha384', 'composer-setup.php') === '9f...') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
Passo 4: Baixar o BookStack
Agora, baixe a última versão do BookStack:
cd /var/www
git clone https://github.com/BookStackApp/BookStack.git
cd BookStack
Passo 5: Configurar o Ambiente
Copie o arquivo .env.example para .env:
cp .env.example .envGere a chave de aplicativo:
php artisan key:generatePasso 6: Configurar o Banco de Dados
Crie um banco de dados para o BookStack. Acesse o MySQL:
sudo mysql -u root -pE execute os seguintes comandos:
CREATE DATABASE bookstack;
CREATE USER 'bookstackuser'@'localhost' IDENTIFIED BY 'senha_do_usuario';
GRANT ALL PRIVILEGES ON bookstack.* TO 'bookstackuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Passo 7: Configurar Nginx
Crie um arquivo de configuração do Nginx para o BookStack:
sudo nano /etc/nginx/sites-available/bookstack
Adicione o seguinte conteúdo ao arquivo:
server {
listen 80;
server_name seudominio.com; # Substitua por seu domínio
root /var/www/BookStack/public;
index index.php index.html index.htm;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # Verifique a versão do PHP
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
Ative a configuração e reinicie o Nginx:
sudo ln -s /etc/nginx/sites-available/bookstack /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
Passo 8: Executar as Migrações
Finalmente, execute as migrações do banco de dados:
php artisan migrate
Passo 9: Acessar o BookStack
Agora você pode acessar o BookStack no seu navegador usando o seu domínio. Complete a configuração inicial e comece a usar!
