Como instalar o Invoice Ninja no Ubuntu 16.04

• Introdução
• Pré-requisitos
• Etapa 1: atualizar o sistema
• Etapa 2: Instalar a pilha LEMP
• Etapa 3: configurar o banco de dados
• Etapa 4: Configurar o PHP-FPM
• Etapa 5: faça o download e configure o Invoice Ninja
• Etapa 6: configurar o Nginx for Invoice Ninja
• Etapa 7: acessar a fatura Ninja

Introdução

O Invoice Ninja é um aplicativo baseado na Web gratuito e de código aberto que pode ser usado para faturamento, pagamentos, controle de tempo e muito mais. É a melhor solução para clientes de faturamento e cobrança. Você pode criar e enviar faturas on-line facilmente em segundos. O Invoice Ninja permite criar faturas personalizadas e mostrar faturas ao vivo como um arquivo PDF.

Neste tutorial, explicarei como instalar o Invoice Ninja no servidor Ubuntu 16.04.

Pré-requisitos

• Uma instância do servidor Ubuntu 16.04 com 2 GB de RAM instalada.
• Um usuário sudo com privilégios de root.
• Você precisará conhecer o IP principal da sua instância do servidor. Neste tutorial, vou usar 192.168.0.227.

Etapa 1: atualizar o sistema

Antes de instalar qualquer pacote na instância do servidor Ubuntu, é recomendável atualizar o sistema. Entre no seu servidor via SSH como seu usuário sudo e execute o seguinte comando:

sudo apt-get update -y
sudo apt-get upgrade -y
sudo shutdown -r now

Etapa 2: Instalar a pilha LEMP

Antes de iniciar, você precisará configurar uma pilha LEMP (Nginx, MariaDB e PHP) em seu servidor.

Primeiro, instale o Nginx e o MariaDB com o seguinte comando:

sudo apt-get install nginx mariadb-server -y

Quando a instalação estiver concluída, inicie os serviços Nginx e MariaDB e permita que eles iniciem na inicialização:

sudo systemctl start nginx
sudo systemctl enable nginx
sudo systemctl start mysql
sudo systemctl enable mysql

Em seguida, você precisará do PHP 7 e PHP-FPM para a instalação do Invoice Ninja.

Você pode instalar o PHP-FPM e as outras extensões PHP necessárias com o seguinte comando:

sudo apt-get install php7.0-fpm php7.0-gd php7.0-xml php7.0-mysql php7.0-zip php7.0-curl php7.0-gmp php7.0-mbstring php7.0-mcrypt

Depois que a instalação terminar, você precisará modificar o php.iniarquivo de configuração:

sudo nano /etc/php/7.0/fpm/php.ini

Mude a seguinte linha:

cgi.fix_pathinfo=0

Salve e feche o arquivo.

Etapa 3: configurar o banco de dados

Por padrão, a instalação do MariaDB não foi protegida. Você precisará protegê-lo. Você pode fazer isso executando mysql_secure_installation script.

sudo mysql_secure_installation

Responda a todas as perguntas, como mostrado abaixo:

Set root password? [Y/n] Y
New password:
Re-enter new 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

Quando tudo estiver pronto, conecte-se usando o shell do MySQL com o seguinte comando:

mysql -u root -p

Digite sua senha root e pressione "enter", você verá o shell do MySQL (MariaDB).

Crie um novo banco de dados e um novo usuário para o Invoice Ninja.

MariaDB [(none)]> CREATE DATABASE ninja_db;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON ninja_db.* TO 'ninja'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> \q

Etapa 4: Configurar o PHP-FPM

Configure o conjunto PHP-FPM para o usuário Nginx:

sudo nano /etc/php/7.0/fpm/pool.d/www-data.conf

Adicione as seguintes linhas:

[www-data]
user = www-data
group = www-data
listen = /var/run/php-fpm-www-data.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0666
pm = ondemand
pm.max_children = 5
pm.process_idle_timeout = 10s
pm.max_requests = 200
chdir = /

Salve e feche o arquivo quando terminar e reinicie o PHP-FPM para aplicar essas alterações.

systemctl restart php7.0-fpm

Etapa 5: faça o download e configure o Invoice Ninja

Você pode baixar a versão estável mais recente do Invoice Ninja do repositório GitHub com o seguinte comando:

cd /var/www/html/
sudo git clone https://github.com/hillelcoren/invoice-ninja.git ninja

Você também precisará instalar o Composer, um gerenciador de dependências para PHP. Você pode instalá-lo com o seguinte comando:

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

Em seguida, instale todas as dependências do Invoice Ninja usando o composercomando conforme mostrado abaixo:

cd /var/www/html/ninja
sudo composer install --no-dev -o

Depois que a instalação estiver concluída, renomeie o .envarquivo e faça algumas alterações.

sudo mv .env.example .env
sudo nano .env

Mude as linhas como mostrado abaixo:

DB_DATABASE=ninja_db
DB_USERNAME=ninja
DB_PASSWORD=password

Salve o arquivo quando terminar e execute o seguinte comando para preparar o banco de dados:

sudo php artisan migrate

Você será solicitado a executar o comando, digite "yes" e pressione "enter".

Em seguida, propague o banco de dados com os registros, como mostrado abaixo:

sudo php artisan db:seed

Digite "yes" e pressione "enter".

Em seguida, altere a propriedade do /var/www/html/ninjadiretório:

sudo chown -R www-data:www-data /var/www/html/ninja/

Etapa 6: configurar o Nginx for Invoice Ninja

Em seguida, você precisará criar um certificado SSL e criar uma nova configuração de host virtual para o Invoice Ninja.

Primeiro, crie um diretório para SSL:

sudo mkdir -p /etc/nginx/cert/

Em seguida, gere um certificado SSL com o seguinte comando:

sudo openssl req -new -x509 -days 365 -nodes -out /etc/nginx/cert/ninja.crt -keyout /etc/nginx/cert/ninja.key

Conceda permissões apropriadas ao arquivo de certificado.

sudo chmod 600 /etc/nginx/cert/*

Crie um novo arquivo de configuração de host virtual dentro do /etc/nginx/diretório.

sudo nano /etc/nginx/conf.d/ninja.conf

Adicione as seguintes linhas:

server {
    listen  80;
    server_name 192.168.0.227;
    add_header Strict-Transport-Security max-age=2592000;
    rewrite ^ https://$server_name$request_uri? permanent;
}

server {
    listen  443 default;
    server_name 192.168.0.227;
    ssl on;
    ssl_certificate     /etc/nginx/cert/ninja.crt;
    ssl_certificate_key /etc/nginx/cert/ninja.key;
    ssl_session_timeout 5m;
    ssl_ciphers  'AES128+EECDH:AES128+EDH:!aNULL';
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    root /var/www/html/ninja/public;
    index index.html index.htm index.php;
    charset utf-8;
    location / {
    try_files $uri $uri/ /index.php?$query_string;
       }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    # Access and Error Log for Invoice Ninja
    access_log  /var/log/nginx/ininja.access.log;
    error_log   /var/log/nginx/ininja.error.log;

    sendfile off;

    # Handle PHP Applications
    location ~ \.php$ {
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass unix:/var/run/php-fpm-www-data.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_intercept_errors off;
    fastcgi_buffer_size 16k;
    fastcgi_buffers 4 16k;
    }

    location ~ /\.ht {
       deny all;
       }
    }

Salve e feche o arquivo. Ative o host virtual com o seguinte comando.

sudo ln -s /etc/nginx/sites-available/ninja /etc/nginx/sites-enabled/

Por fim, reinicie o servidor da web Nginx.

sudo systemctl restart nginx

Etapa 7: acessar a fatura Ninja

Antes de acessar a interface da web do Invoice Ninja, você precisará permitir serviços HTTP e HTTPS através do firewall UFW. Execute os seguintes comandos para abrir essas portas:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Por fim, abra seu navegador e acesse o URL https://192.168.0.227. Você pode concluir as etapas necessárias para concluir a instalação.

Parabéns! Instalamos com sucesso o Invoice Ninja com Nginx e MariaDB no servidor Ubuntu 16.04.