Como Instalar o Flarum Fórum de Próxima Geração no Ubuntu 24.04

Flarum é um software de fórum gratuito e de código aberto em PHP, JavaScript e TypeScript. É um software de fórum de próxima geração projetado para ser minimalista com alta extensibilidade através de extensões. O Flarum é uma solução moderna para software de fórum, é rápido, simples e fácil de usar e instalar.

Neste tutorial, vamos mostrar como instalar o Flarum no Ubuntu 24.04. Você instalará o Flarum com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), e depois o protegerá via HTTPS usando Certbot e letsencrypt.

Pré-requisitos

Para seguir este tutorial, certifique-se de que você tem os seguintes requisitos:

• Um Ubuntu 24.04 ‘Noble Numbat’.
• Um usuário não-root com privilégios de administrador.
• Um UFW (Firewall Descomplicado) em execução.
• Um nome de domínio apontado para um endereço IP do servidor.

Instalando Dependências

O Flarum é um software de fórum de código aberto escrito em PHP. Para instalá-lo, você precisa instalar dependências no seu servidor Ubuntu. Isso inclui a pilha LAMP (Linux, Apache, MySQL/MariaDB), Git e Composer.

Nesta seção, você instalará as dependências para o Flarum via o repositório do Ubuntu.

Primeiro, execute o comando abaixo para atualizar o índice de pacotes do Ubuntu.

sudo apt update

Agora execute os seguintes comandos para instalar dependências como a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), Composer e Git no seu sistema Ubuntu.

sudo apt install apache2 mariadb-server php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap php-tokenizer composer git

Digite Y para confirmar a instalação.

Após a instalação, verifique o status do serviço Apache com o seguinte comando. Você verá que o servidor web Apache está habilitado com o status ‘ativo (em execução)‘.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Agora verifique o servidor MariaDB com o seguinte comando. Você verá uma saída semelhante, onde o MariaDB está habilitado e em execução.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por fim, verifique as versões do PHP e do Composer com o seguinte comando. Você verá que PHP 8.3 e Composer 2.7.1 estão instalados no seu sistema Ubuntu.

php -v  
sudo -u www-data composer -v

Configurando UFW (Firewall Descomplicado)

Após instalar as dependências, você precisa permitir o acesso ao servidor web Apache via UFW (Firewall Descomplicado). O servidor web Apache fornece um perfil de aplicativo UFW ‘Apache Full‘ para permitir acesso tanto HTTP quanto HTTPS.

Execute o comando abaixo para abrir o acesso tanto HTTP quanto HTTPS via o perfil ‘Apache Full‘. Quando adicionado, você verá uma saída ‘Regras Adicionadas‘.

sudo ufw allow 'Apache Full'

Agora verifique a lista de regras no seu UFW com o seguinte comando.

sudo ufw status

Você deve obter o perfil ‘Apache Full‘ habilitado no seu firewall. Com isso, tanto o acesso HTTP quanto HTTPS ao seu servidor web Apache é permitido.

Configurando PHP

Nesta seção, você configurará o PHP para o Flarum editando o arquivo ‘php.ini’. Você precisará ajustar algumas configurações do PHP, como memory_limit e upload_max_filesize para a sua instalação do Flarum.

Abra a configuração padrão do PHP ‘php.ini‘ usando o seguinte comando do editor nano.

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

Altere a configuração padrão do PHP com o seguinte. Certifique-se de ajustar o valor para as opções memory_limit e date.timezone.

memory_limit = 512M  
upload_max_filesize = 150M  
max_execution_time = 600  
date.timezone = Europe/Paris

Quando terminar, salve o arquivo e saia.

Agora execute o comando abaixo para reiniciar o servidor web Apache e aplicar a nova configuração do PHP.

sudo systemctl restart apache2

Configurando o servidor MariaDB

Após configurar o PHP, você irá proteger o servidor MariaDB e criar um novo banco de dados e usuário que serão usados pelo Flarum. Você pode proteger o MariaDB via o comando ‘mariadb-secure-installation‘, e depois criar um novo banco de dados e usuário via o cliente ‘mariadb‘.

Para proteger o servidor MariaDB, execute o comando ‘mariadb-secure-installation‘ abaixo. Com isso, você será questionado sobre algumas configurações do MariaDB.

sudo mariadb-secure-installation

Abaixo estão as configurações que você será solicitado:

• A instalação padrão do MariaDB vem sem uma senha, pressione ENTER quando solicitado pela senha.
• Agora digite Y para configurar a senha root do MariaDB. Em seguida, digite a nova senha para o MariaDB e repita a senha.
• Digite Y para remover o usuário anônimo da sua instalação do MariaDB.
• Digite Y novamente quando solicitado para desabilitar o login remoto para o usuário root do MariaDB.
• Digite Y para remover o banco de dados de teste padrão da sua instalação do MariaDB.
• Por fim, digite Y para recarregar os privilégios das tabelas e aplicar novas alterações.

Uma vez que o MariaDB esteja seguro, faça login no servidor MariaDB com o seguinte comando. Digite sua senha root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário para o Flarum. Neste exemplo, você criará um novo banco de dados ‘flarum‘, um usuário ‘flarum‘, com a senha ‘password‘. Você pode substituir essas informações pelas suas.

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

Em seguida, execute a consulta abaixo para verificar os privilégios do usuário ‘flarum‘. Isso garantirá que o usuário ‘flarum‘ possa acessar o banco de dados ‘flarum‘.

SHOW GRANTS FOR flarum@localhost;

Você pode ver abaixo que o usuário ‘flarum‘ pode acessar o banco de dados ‘flarum‘.

Agora digite quit para sair do servidor MariaDB.

Baixando o código-fonte do Flarum

Com todas as dependências configuradas, você está pronto para baixar o código-fonte do Flarum. Nesta seção, você criará um novo diretório raiz de documentos para o Flarum e, em seguida, baixará o código-fonte do Flarum via Composer.

Primeiro, execute o comando abaixo para criar um novo diretório de instalação do Flarum ‘/var/www/flarum/‘ e diretórios para o Composer ‘/var/www/.cache‘ e ‘/var/www/.config‘. Em seguida, altere a propriedade desses diretórios para o usuário ‘www-data‘.

mkdir -p /var/www/{.cache,.config,flarum}  
chown -R www-data:www-data /var/www/{.cache,.config,flarum}

Agora mude para o diretório ‘/var/www/flarum/‘ e baixe o código-fonte do Flarum via o comando Composer abaixo.

cd /var/www/flarum/  
sudo -u www-data composer create-project flarum/flarum .

Você pode ver abaixo o processo de download do código-fonte do Flarum.

Após o processo de download ser concluído, execute o seguinte comando ‘ls‘ para verificar o código-fonte do Flarum.

ls -ah

Você deve ver o código-fonte do Flarum baixado como o seguinte:

Configurando o host virtual do Apache para o Flarum

Após baixar o Flarum, você precisa criar um novo host virtual do Apache. Portanto, certifique-se de que você preparou seu nome de domínio para a instalação do Flarum.

Antes de criar um host virtual, execute o seguinte comando para habilitar os módulos do Apache ‘ssl‘, ‘rewrite‘ e ‘headers‘.

sudo a2enmod ssl rewrite headers

Agora crie uma nova configuração de host virtual ‘/etc/apache2/sites-available/flarum.conf‘ usando o seguinte comando do editor nano.

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

Insira a configuração abaixo e certifique-se de alterar a opção ServerName com seu nome de domínio e o caminho do diretório Document-Root para sua instalação do Flarum.

  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/flarum/public  
 ServerName forum.howtoforge.local  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
   
   
 RewriteEngine on  
 RewriteBase /  
 RewriteCond %{REQUEST_FILENAME} !-f  
 RewriteRule ^(.*) index.php [PT,L]  
   

Quando terminar, salve o arquivo e saia do editor.

Em seguida, execute o comando abaixo para ativar o arquivo de host virtual ‘flarum.conf’ e verificar sua sintaxe do Apache.

sudo a2ensite flarum.conf  
sudo apachectl configtest

Você deve ter uma saída ‘Sintaxe OK‘ quando tiver uma configuração adequada do Apache.

Por fim, execute o seguinte comando para reiniciar o servidor web Apache e aplicar a nova configuração do host virtual do Flarum. Com isso, seu Flarum deve ser acessível.

sudo systemctl restart apache2

Protegendo o Flarum com HTTPS

Se você estiver executando o Flarum em um domínio público, pode protegê-lo com HTTPS usando Certbot e certificados Letsencrypt. Se você estiver usando um domínio local, pode usar certificados autoassinados.

Instale o Certbot e o plugin Certbot Apache com o comando abaixo. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-apache

Agora execute o seguinte comando ‘certbot’ para gerar certificados SSL/TLS para sua instalação do Flarum. Certifique-se de alterar os detalhes do nome de domínio e do endereço de e-mail com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d forum.howtoforge.local

Uma vez que o processo esteja completo, sua instalação do Flarum deve estar protegida com HTTPS. E seus certificados SSL/TLS devem estar disponíveis no diretório ‘/etc/letsencrypt/live/domain.com‘.

Instalando o Flarum

Abra seu navegador web e visite seu nome de domínio, como https://forum.howtoforge.local/. Se sua configuração for bem-sucedida, você deve obter o assistente de instalação do Flarum.

Insira o título do seu fórum, detalhes do banco de dados MariaDB, usuário e senha. Em seguida, insira os detalhes do usuário administrador, e-mail e senha para sua nova instalação do Flarum.

Clique no botão ‘Instalar Flarum‘ para continuar a instalação.

Uma vez que a instalação esteja completa, você verá o painel de administração do Flarum como o seguinte:

Agora clique no seu ícone de usuário e selecione Administração. Isso mostrará os detalhes da sua instalação do Flarum.

Como você pode ver abaixo, o Flarum 1.8.5 está instalado com PHP 8.3 e servidor MariaDB 10.11.

Conclusão

Parabéns! Você agora completou a instalação do Flarum no Ubuntu 24.04. Você tem o Flarum em execução com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), e também protegeu o Flarum com HTTPS via Certbot e Letsencrypt.