Como Instalar o InvoicePlane com Nginx no FreeBSD 12

InvoicePlane é um aplicativo de faturamento gratuito e de código aberto. Este tutorial mostrará como instalar o InvoicePlane em um sistema FreeBSD 12.

Requisitos

• WebServer (Apache, NGINX). Este tutorial usará Nginx.
• MySQL versão 5.5 ou superior ou a versão equivalente do MariaDB.
• PHP versão 7.0, 7.1 ou 7.2 com as seguintes extensões PHP instaladas e ativadas:
  • php-gd
  • php-hash
  • php-json
  • php-mbstring
  • php-mcrypt
  • php-mysqli
  • php-openssl
  • php-recode
  • php-xmlrpc
  • php-zlib

Pré-requisitos

• Um servidor rodando FreeBSD 12.
• Um usuário não-root com privilégios sudo.

Passos iniciais

Verifique sua versão do FreeBSD:

uname -ro  
# FreeBSD 12.1-RELEASE

Configure o fuso horário:

tzsetup

Atualize os pacotes do seu sistema operacional (software). Este é um primeiro passo importante porque garante que você tenha as últimas atualizações e correções de segurança para os pacotes de software padrão do seu sistema operacional:

freebsd-update fetch install  
pkg update && pkg upgrade -y

Instale alguns pacotes essenciais que são necessários para a administração básica do sistema operacional FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash

Passo 1 - Instalar PHP e extensões PHP necessárias

O aplicativo web InvoicePlane requer PHP versão 7.0 ou superior.

Instale o PHP, bem como as extensões PHP necessárias:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-mysqli php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Verifique a versão do PHP:

php --version  
  
# PHP 7.2.7 (cli) (built: Jul 25 2019 01:28:53) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies

Ative e inicie o serviço PHP-FPM:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Passo 2 - Instalar MySQL

Instale o servidor de banco de dados MySQL:

sudo pkg install -y mysql57-server

Verifique a versão do MySQL:

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.26, for FreeBSD12.0 (amd64) using  EditLine wrapper

Ative e inicie o serviço MySQL:

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

Execute o script mysql_secure_installation para melhorar a segurança do MySQL e definir a senha para o usuário root do MySQL:

sudo mysql_secure_installation

Responda a cada uma das perguntas:

Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
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

Conecte-se ao shell do MySQL como usuário root:

sudo mysql -u root -p  
# Enter password  

Crie um banco de dados MySQL vazio e um usuário para Matomo e lembre-se das credenciais:

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

Saia do MySQL:

exit

Substitua dbname, username e password pelos seus próprios nomes.

Passo 3 - Instalar acme.sh e obter certificado Let’s Encrypt (opcional)

Proteger seu site com HTTPS não é necessário, mas é uma boa prática proteger o tráfego do seu site. Para obter um certificado TLS do Let’s Encrypt, usaremos o cliente Acme.sh. Acme.sh é um software de shell UNIX puro para obter certificados TLS do Let’s Encrypt com zero dependências. 

Baixe e instale o Acme.sh:

sudo pkg install -y acme.sh

Verifique a versão do Acme.sh:

acme.sh --version  
# v2.8.2

Obtenha certificados RSA e ECC/ECDSA para seu domínio/nome do host:

# RSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Após executar os comandos acima, seus certificados e chaves estarão em:

• Para RSA: diretório /etc/letsencrypt/example.com.
• Para ECC/ECDSA: diretório /etc/letsencrypt/example.com_ecc.

Passo 3 - Instalar NGINX

Instale o servidor web NGINX:

sudo pkg install -y nginx

Verifique a versão do NGINX:

nginx -v  
# nginx version: nginx/1.14.2

Inicie e ative o serviço NGINX:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Configure o Nginx para o InvoicePlane executando:

sudo vim /usr/local/etc/nginx/invoiceplane.conf

E preencha o arquivo com a seguinte configuração:

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

    server_name example.com;

    root /usr/local/www/invoiceplane;

    index index.php index.html;

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

    location ~* \.php$ {  
      fastcgi_pass 127.0.0.1:9000;  
      include fastcgi_params;  
      fastcgi_index index.php5;  
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    }
}

Teste a configuração do NGINX:

sudo nginx -t

Recarregue o NGINX:

sudo service nginx restart

Passo 4 - Instalar InvoicePlane

Baixe a versão estável mais recente do InvoicePlane e extraia o arquivo:

sudo mkdir -p /usr/local/www  
cd /usr/local/www  
sudo curl -O -J -L https://invoiceplane.com/download/v1.5.9  
sudo unzip v1.5.9.zip  
sudo rm v1.5.9.zip  
sudo mv ip invoiceplane

Navegue até o diretório /var/www/invoiceplane:

cd /usr/local/www/invoiceplane

Faça uma cópia do arquivo ipconfig.php.example e renomeie a cópia para ipconfig.php:

sudo cp ipconfig.php.example ipconfig.php

Abra o arquivo ipconfig.php e adicione sua URL nele:

sudo vim ipconfig.php  
# Algo assim  
IP_URL=http://example.com

Altere a propriedade do diretório /usr/local/www/invoiceplane para www:

sudo chown -R www:www /usr/local/www/invoiceplane

Execute sudo vim /etc/php.ini e defina date.timezone:

date.timezone = Region/City

Reinicie o serviço PHP-FPM:

sudo service php-fpm restart

Execute o instalador do InvoicePlane a partir do seu navegador da web e siga as instruções:

http://example.com/index.php/setup

Uma vez que a instalação tenha terminado, você pode fazer login no InvoicePlane usando o endereço de e-mail e a senha que você escolheu durante a instalação.

Se você quiser proteger sua instalação, pode desativar a configuração. Para fazer isso, substitua a linha DISABLE_SETUP=false por DISABLE_SETUP=true no seu arquivo ipconfig.php.

Passo 5 - Completar a configuração do InvoicePlane

O InvoicePlane está agora instalado e configurado, é hora de acessar seu assistente de instalação web.

Abra seu navegador da web e digite a URL http://example.com. Você será redirecionado para a seguinte página:

Agora, clique no botão Configuração. Você deve ver a seguinte página:

Em seguida, escolha o idioma e clique no botão Continuar. Você deve ver a seguinte página:

Em seguida, clique no botão Continuar. Você deve ver a seguinte página:

Aqui, forneça os detalhes do seu banco de dados e clique no botão Tentar Novamente. Você deve ver a seguinte página:

Agora, clique no botão Continuar. Você deve ver a seguinte página:

Agora, clique no botão Continuar. Você deve ver a seguinte página:

Agora, forneça todos os detalhes necessários e clique no botão Continuar. Uma vez que a instalação esteja concluída, você deve ver a seguinte página:

Agora, clique no botão Login para acessar a administração do InvoicePlane.

Links

• https://invoiceplane.com/
• https://github.com/InvoicePlane/InvoicePlane