Ubuntu 20.04 (Debian)

Sumário
  1. Introdução
  2. Instalar Apache
  3. Instalar MariaDB
  4. Instalar PHP e pacotes necessários
  5. Configurar o Apache para usar o PHP 8.1:
  6. Instalar o Páramo
    1. Download
    2. GitHub
  7. Configurar o Páramo

Introdução

As instruções abaixo foram feitas usando um servidor VPS com sistema operacional Ubuntu 20.04 e devem funcionar em outros sistemas operacionais baseados em Debian. Essa seção pressupõe familiaridade com conexão SSH, uso do terminal e instalação de pacotes em sistemas Linux.

Instalar Apache

sudo apt install apache2

Habilite o módulo rewrite do Apache:

sudo a2enmod rewrite

Instalar MariaDB

sudo apt install mariadb-server

Faça a configuração inicial do MariaDB:

sudo mysql_secure_installation

Instalar PHP e pacotes necessários

Instale as dependências necessárias:

sudo apt install software-properties-common ca-certificates lsb-release apt-transport-https 

Atualize o repositório de pacotes:

sudo apt update

Adicione o repositório PPA do PHP (ondjrej/php)

sudo add-apt-repository ppa:ondrej/php

Atualize o repositório de pacotes novamente:

sudo apt update && apt upgrade -y

Instale o PHP 8.1 e as extensões necessárias:

sudo apt-get install -y php8.1-cli php8.1-cgi php8.1-common php8.1-fpm php8.1-mysql php8.1-zip php8.1-gd php8.1-mbstring php8.1-curl php8.1-xml php8.1-imagick

Verifique se o PHP foi instalado corretamente:

php -v

Configurar o Apache para usar o PHP 8.1:

Ative os módulos proxy_fcgi e setenvif:

sudo a2enmod proxy_fcgi setenvif

Ative as configurações do módulo php8.1:

sudo a2enconf php8.1-fpm

Reinicie o Apache:

sudo systemctl restart apache2

Instalar o Páramo

Existem duas possibilidades para instalar o Páramo, por download ou pelo GitHub.

Download

Vá para a pasta root do Apache:

cd /var/www/html

Baixe a última versão do sistema

wget https://github.com/paramosoftware/paramo/archive/refs/tags/1.4.22.tar.gz

Descompacte o arquivo baixado e renomeie a pasta:

tar -xzf paramo-1.4.22.tar.gz && mv paramo-1.4.22 paramo

Entre na pasta paramo:

cd paramo

Altere as permissões das pastas:

Por padrão, o usuário do Apache no Ubuntu é www-data. O usuário pode ser diferente em outras distribuições Linux. Para descobrir o usuário do Apache, execute o comando ps aux | grep apache e verifique o usuário que aparece na primeira coluna. Em alguns servidores, o usuário pode ser www-data, apache ou httpd.

sudo chown -R www-data:www-data app/assets/custom/ app/media/ config/ src/logs/ src/vendors/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer
sudo chmod -R 775 app/assets/custom/ app/media/ config/ src/logs/ src/vendors/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer

GitHub

Instale o Git:

sudo apt install git

Vá para a pasta root do Apache:

cd /var/www/html

Clone o repositório do Páramo:

git clone https://github.com/paramosoftware/paramo.git --branch 1.4.22

Entre na pasta do Páramo:

cd paramo

Altere as permissões das pastas:

sudo chown -R www-data:www-data app/assets/custom/ app/media/ config/ src/logs/ src/vendors/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer
sudo chmod -R 775 app/assets/custom/ app/media/ config/ src/logs/ src/vendors/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer

Configurar o Páramo

Acesse as instruções na seção Configurar o Páramo.