Flarum Installation · 19 min read · Oct 20, 2025
Como Instalar o Software de Comunidade Flarum no Debian 12
Flarum é um software de comunidade de código aberto projetado para criar e gerenciar fóruns online com facilidade. Construído com uma interface moderna e elegante, o Flarum oferece uma experiência de usuário simplificada, otimizada para desempenho e simplicidade. É altamente personalizável através de um robusto sistema de extensões, permitindo que os administradores adaptem seus fóruns às necessidades e preferências específicas. O Flarum suporta design responsivo, garantindo compatibilidade em vários dispositivos e recursos como notificações em tempo real, incorporação de mídia rica e ferramentas de moderação sem costura. Sua base em PHP e MySQL o torna acessível a uma ampla gama de ambientes de hospedagem na web, atraindo pequenas comunidades e grandes organizações em busca de uma plataforma eficiente para discussões online.
Neste tutorial, aprenderemos como instalar o Software de Comunidade Flarum em um servidor baseado no Debian 12.
Pré-requisitos
- Um servidor rodando Debian 12.
- Um usuário não-root com privilégios sudo.
- Um Nome de Domínio Totalmente Qualificado (FQDN) como
flarum.example.comapontando para seu servidor. - Certifique-se de que seu servidor tenha armazenamento swap habilitado se você estiver em um servidor com 1GB de RAM.
- Certifique-se de que tudo esteja atualizado.
$ sudo apt update && sudo apt upgrade - O Flarum requer alguns pacotes essenciais para funcionar. Alguns deles já estarão no seu servidor.
$ sudo apt install curl wget nano software-properties-common dirmngr apt-transport-https ca-certificates lsb-release debian-archive-keyring gnupg2 ufw unzip -y
Passo 1 - Configurar o Firewall
O primeiro passo é configurar o firewall. O Debian vem com o ufw (Uncomplicated Firewall) por padrão.
Verifique se o firewall está em execução.
$ sudo ufw status
Você receberá a seguinte saída.
Status: inactive
Permita a porta SSH para que o firewall não quebre a conexão atual ao habilitá-lo.
$ sudo ufw allow OpenSSH
Permita também as portas HTTP e HTTPS.
$ sudo ufw allow http
$ sudo ufw allow https
Habilite o Firewall
$ sudo ufw enable
Comando pode interromper conexões ssh existentes. Prosseguir com a operação (y|n)? y
Firewall está ativo e habilitado na inicialização do sistema
Verifique o status do firewall novamente.
$ sudo ufw status
Você deve ver uma saída semelhante.
Status: active
Para Ação De
-- ------ ----
OpenSSH ALLOW Anywhere
80/tcp ALLOW Anywhere
443 ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
80/tcp (v6) ALLOW Anywhere (v6)
443 (v6) ALLOW Anywhere (v6)
Passo 2 - Instalar o Nginx
O Debian 12 vem com uma versão mais antiga do Nginx. Para instalar a versão mais recente, você precisa baixar o repositório oficial do Nginx.
Importe a chave de assinatura do Nginx.
$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
Adicione o repositório para a versão estável do Nginx.
$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/debian `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
Atualize os repositórios do sistema.
$ sudo apt update
Instale o Nginx.
$ sudo apt install nginx
Verifique a instalação. Em sistemas Debian, o seguinte comando funcionará apenas com sudo.
$ sudo nginx -v
nginx version: nginx/1.24.0
Inicie o servidor Nginx.
$ sudo systemctl start nginx
Verifique o status do serviço.
$ sudo systemctl status nginx
? nginx.service - nginx - servidor web de alto desempenho
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; preset: enabled)
Active: active (running) since Thu 2023-11-09 12:08:18 UTC; 1s ago
Docs: https://nginx.org/en/docs/
Process: 1957 ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf (code=exited, status=0/SUCCESS)
Main PID: 1958 (nginx)
Tasks: 2 (limit: 1107)
Memory: 1.7M
CPU: 6ms
CGroup: /system.slice/nginx.service
??1958 "nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf"
??1959 "nginx: worker process"
Abra o endereço IP do seu servidor no seu navegador. Você deve ver a seguinte página, o que significa que seu servidor está ativo e funcionando.
Passo 3 - Instalar PHP
O Debian 12 vem com PHP 8.2 por padrão. Você pode instalá-lo executando o seguinte comando.
$ sudo apt install php-cli php-fpm php-mysql php-xml php-gd php-json php-mbstring php-zip php-curl -y
Para sempre ficar na versão mais recente do PHP ou se você quiser instalar várias versões do PHP, adicione o repositório PHP do Ondrej.
Primeiro, importe a chave GPG do repositório Sury.
$ sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
Adicione o repositório PHP do Ondrej Sury.
$ sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
Atualize a lista de repositórios do sistema.
$ sudo apt update
Em seguida, instale o PHP e suas extensões necessárias para o Flarum.
$ sudo apt install php-cli php-fpm php-mysql php-xml php-gd php-json php-mbstring php-zip php-curl -y
Verifique se o PHP está funcionando corretamente.
$ php --version
Você deve ver uma saída semelhante.
PHP 8.2.12 (cli) (built: Oct 27 2023 13:00:10) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.12, Copyright (c) Zend Technologies
with Zend OPcache v8.2.12, Copyright (c), by Zend Technologies
Passo 4 - Instalar o Composer
O Composer é um gerenciador de dependências para PHP. O Flarum precisa do Composer para instalar e executar vários componentes.
Execute os seguintes comandos para instalar o Composer. Primeiro, pegamos o instalador, verificamos o hash para verificá-lo e, em seguida, executamos o instalador usando a linha de comando do PHP. Depois, movemos o binário para o diretório /usr/local/bin.
$ php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
$ php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a450292b6cfd1d64d92e6563bbde02') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
$ php composer-setup.php
$ php -r "unlink('composer-setup.php');"
$ sudo mv composer.phar /usr/local/bin/composer
Verifique se o Composer está instalado corretamente.
$ composer --version
Composer version 2.6.5 2023-10-06 10:11:52
Passo 5 - Instalar o MariaDB
O MariaDB é um substituto direto do MySQL, o que significa que os comandos para executar e operar o MariaDB são os mesmos que os do MySQL.
O Debian 12 vem com o MariaDB 10.11.4 por padrão, que está um pouco desatualizado. Você precisa usar o repositório oficial para obter a versão estável mais recente do MariaDB.
Importe a chave GPG do MariaDB.
$ sudo curl -o /usr/share/keyrings/mariadb-keyring.pgp 'https://mariadb.org/mariadb_release_signing_key.pgp'
Crie o arquivo de repositório do MariaDB.
$ echo "deb [signed-by=/usr/share/keyrings/mariadb-keyring.pgp] https://deb.mariadb.org/10.11/debian `lsb_release -cs` main" | sudo tee /etc/apt/sources.list.d/mariadb-server.list
Atualize a lista de repositórios do sistema.
$ sudo apt update
Emita o seguinte comando para instalar o servidor MariaDB.
$ sudo apt install mariadb-server -y
Verifique se o MariaDB está instalado corretamente.
$ mysql --version
Você deve ver a seguinte saída.
mysql Ver 15.1 Distrib 10.11.6-MariaDB, for debian-linux-gnu (x86_64) using EditLine wrapper
Você também pode usar mariadb --version para verificar a versão.
O serviço MariaDB já está habilitado e em execução. Verifique seu status usando o seguinte comando.
$ sudo systemctl status mariadb
? mariadb.service - MariaDB 10.11.6 servidor de banco de dados
Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; preset: enabled)
Drop-In: /etc/systemd/system/mariadb.service.d
??migrated-from-my.cnf-settings.conf
Active: active (running) since Tue 2023-11-14 08:42:03 UTC; 4min 1s ago
Docs: man:mariadbd(8)
https://mariadb.com/kb/en/library/systemd/
Process: 74903 ExecStartPre=/usr/bin/install -m 755 -o mysql -g root -d /var/run/mysqld (code=exited, status=0/SUCCESS)
Process: 74904 ExecStartPre=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
Process: 74906 ExecStartPre=/bin/sh -c [ ! -e /usr/bin/galera_recovery ] && VAR= || VAR=`cd /usr/bin/..; /usr/bin/galera_recovery`; [ $? -eq 0 ] && systemctl set-environment _WSREP_START_POSITION=$VAR>
Process: 74946 ExecStartPost=/bin/sh -c systemctl unset-environment _WSREP_START_POSITION (code=exited, status=0/SUCCESS)
Process: 74948 ExecStartPost=/etc/mysql/debian-start (code=exited, status=0/SUCCESS)
Main PID: 74935 (mariadbd)
Status: "Atendendo suas solicitações SQL agora..."
Tasks: 9 (limit: 1107)
Memory: 214.9M
CPU: 627ms
CGroup: /system.slice/mariadb.service
??74935 /usr/sbin/mariadbd
Execute o seguinte comando para realizar a configuração padrão, como definir uma senha para o root, remover usuários anônimos, desabilitar login remoto do root e excluir tabelas de teste.
$ sudo mariadb-secure-installation
Você será solicitado a fornecer sua senha root. Como não temos nenhuma senha root definida, pressione a tecla Enter para prosseguir.
NOTE: EXECUTAR TODAS AS PARTES DESTE SCRIPT É RECOMENDADO PARA TODOS OS SERVIDORES MariaDB EM USO PRODUTIVO! POR FAVOR, LEIA CADA ETAPA COM CUIDADO!
Para fazer login no MariaDB para protegê-lo, precisaremos da senha atual para o usuário root. Se você acabou de instalar o MariaDB e não definiu a senha root ainda, deve apenas pressionar enter aqui.
Digite a senha atual para root (pressione enter para nenhum): [PRESSIONE ENTER]
OK, senha usada com sucesso, prosseguindo...
Em seguida, você será perguntado se deseja mudar para o plugin unix_socket. O plugin unix_socket permite que você faça login no MariaDB com suas credenciais de usuário do Linux. Escolha n para pular a troca, uma vez que você já tem uma conta root protegida.
Definir a senha root ou usar o unix_socket garante que ninguém
pode fazer login no usuário root do MariaDB sem a devida autorização.
Você já tem sua conta root protegida, então pode responder 'n' com segurança.
Mudar para autenticação unix_socket [Y/n] n
... pulando.
Em seguida, você será perguntado se deseja mudar sua senha root. No Debian 12, a conta root para o MariaDB está intimamente ligada à manutenção automatizada do sistema, portanto, você não deve alterar os métodos de autenticação configurados para a conta. Fazer isso permitiria que uma atualização de pacote quebrasse o sistema de banco de dados ao remover o acesso à conta administrativa. Digite n para prosseguir.
Você já tem sua conta root protegida, então pode responder 'n' com segurança.
Mudar a senha root? [Y/n] n
... pulando.
A partir daqui, pressione y e depois Enter para aceitar os padrões para todas as perguntas seguintes. Isso removerá o acesso a usuários anônimos, bancos de dados de teste, desabilitará o login remoto do root e carregará as alterações.
Por padrão, uma instalação do MariaDB tem um usuário anônimo, permitindo que qualquer um
faça login no MariaDB sem ter uma conta de usuário criada para
eles. Isso é destinado apenas para testes e para tornar a instalação
um pouco mais suave. Você deve removê-los antes de passar para um
ambiente de produção.
Remover usuários anônimos? [Y/n] y
... Sucesso!
Normalmente, o root deve ser permitido apenas conectar-se de 'localhost'. Isso
assegura que alguém não possa adivinhar a senha root pela rede.
Desabilitar login remoto do root? [Y/n] y
... Sucesso!
Por padrão, o MariaDB vem com um banco de dados chamado 'test' que qualquer um pode
acessar. Isso também é destinado apenas para testes e deve ser removido
antes de passar para um ambiente de produção.
Remover banco de dados de teste e acesso a ele? [Y/n] y
- Excluindo banco de dados de teste...
... Sucesso!
- Removendo privilégios no banco de dados de teste...
... Sucesso!
Recarregar as tabelas de privilégios garantirá que todas as alterações feitas até agora
entrem em vigor imediatamente.
Recarregar tabelas de privilégios agora? [Y/n] y
... Sucesso!
Limpando...
Tudo pronto! Se você completou todos os passos acima, sua instalação do MariaDB
agora deve estar segura.
Obrigado por usar o MariaDB!
É isso. Na próxima vez que você quiser fazer login no shell do MariaDB, use o seguinte comando.
$ sudo mysql
Digite sua senha root do Linux quando solicitado.
Bem-vindo ao monitor do MariaDB. Os comandos terminam com ; ou \g.
Seu ID de conexão MariaDB é 39
Versão do servidor: 10.11.6-MariaDB-1:10.11.6+maria~deb12 distribuição binária do mariadb.org
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab e outros.
Digite 'help;' ou '\h' para ajuda. Digite '\c' para limpar a declaração de entrada atual.
MariaDB [(nenhum)]>
Pressione exit para fechar o shell do MariaDB.
Passo 6 - Configurar o MariaDB
Faça login no shell do MariaDB.
$ sudo mysql
Crie um novo banco de dados MySQL, um usuário de banco de dados e uma senha para sua instalação do Flarum.
MariaDB> CREATE DATABASE flarum;
MariaDB> CREATE USER 'flarumuser'@'localhost' IDENTIFIED BY 'yourpassword';
MariaDB> GRANT ALL PRIVILEGES ON flarum.* TO 'flarumuser'@'localhost';
Substitua flarum, flarumuser e yourpassword pelas credenciais de sua escolha. Escolha uma senha forte.
Além disso, crie um usuário administrativo com as mesmas capacidades que a conta root.
MariaDB> GRANT ALL ON *.* TO 'admin'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
Recarregue os privilégios para garantir que eles sejam salvos na sessão atual.
MariaDB> FLUSH PRIVILEGES;
Saia do shell do MariaDB.
MariaDB> exit
Passo 7 - Instalar o Flarum
Crie um diretório onde o Flarum viverá.
$ sudo mkdir /var/www/flarum -p
Usando a diretiva -p cria diretórios pai que não existiam antes.
Altere a propriedade do diretório Flarum para o usuário Linux atualmente logado, para que você possa executar comandos sem usar sudo.
$ sudo chown -R $USER:$USER /var/www/flarum
Navegue até a pasta de instalação.
$ cd /var/www/flarum
Baixe e instale o Flarum usando o Composer.
$ composer create-project flarum/flarum .
Altere a propriedade do diretório Flarum para nginx para o servidor Nginx.
$ sudo chown -R nginx:nginx /var/www/flarum
Permita acesso de gravação ao diretório.
$ sudo chmod 775 -R /var/www/flarum
A partir daqui, o Composer precisará de permissões sudo para executar, o que não é recomendado. Você também pode alterar as permissões de grupo do diretório para seu usuário Linux e mudá-las de volta para nginx após terminar com o Composer. Esta não é uma solução ideal, pois requer que você execute os mesmos comandos repetidamente. Uma solução mais permanente é adicionar seu nome de usuário ao grupo nginx. Execute o seguinte comando para adicionar seu usuário Linux atualmente logado ao grupo nginx.
$ sudo usermod -a -G nginx $USER
Para aplicar a nova associação ao grupo, saia do servidor e entre novamente, ou digite o seguinte.
su - ${USER}
Passo 8 - Instalar SSL
Precisamos instalar o Certbot para gerar o certificado SSL. Você pode instalar o Certbot usando o repositório do Debian ou pegar a versão mais recente usando a ferramenta Snapd. Usaremos a versão Snapd.
O Debian 12 não vem com o Snapd instalado. Instale o pacote Snapd.
$ sudo apt install snapd
Execute os seguintes comandos para garantir que sua versão do Snapd esteja atualizada.
$ sudo snap install core && sudo snap refresh core
Instale o Certbot.
$ sudo snap install --classic certbot
Use o seguinte comando para garantir que o comando Certbot possa ser executado criando um link simbólico para o diretório /usr/bin.
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
Verifique se o Certbot está funcionando corretamente.
$ certbot --version
certbot 2.7.4
Gere o certificado SSL.
$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m [email protected] -d flarum.example.com
O comando acima fará o download de um certificado para o diretório /etc/letsencrypt/live/flarum.example.com em seu servidor.
Gere um certificado de grupo Diffie-Hellman.
$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096
Verifique o serviço do agendador de renovação do Certbot.
$ sudo systemctl list-timers
Você encontrará snap.certbot.renew.service como um dos serviços agendados para execução.
NEXT LEFT LAST PASSED UNIT ACTIVATES
---------------------------------------------------------------------------------------------------------------------------
Tue 2023-11-14 15:39:00 UTC 24min left Tue 2023-11-14 15:09:02 UTC 5min ago phpsessionclean.timer phpsessionclean.service
Tue 2023-11-14 17:33:00 UTC 2h 18min left - - snap.certbot.renew.timer snap.certbot.renew.service
Tue 2023-11-14 19:03:30 UTC 3h 49min left Tue 2023-11-14 15:12:10 UTC 1min 58s ago apt-daily.timer apt-daily.service
Faça um teste do processo para verificar se a renovação do SSL está funcionando bem.
$ sudo certbot renew --dry-run
Se você não ver erros, está tudo pronto. Seu certificado será renovado automaticamente.
Passo 9 - Configurar PHP-FPM
Abra o arquivo /etc/php/8.2/fpm/pool.d/www.conf.
$ sudo nano /etc/php/8.2/fpm/pool.d/www.conf
Precisamos definir o usuário/grupo Unix dos processos PHP para nginx. Encontre as linhas user=www-data e group=www-data no arquivo e altere-as para nginx.
; Usuário/grupo Unix dos processos filhos. Isso pode ser usado apenas se o usuário do processo mestre
; está em execução como root. É definido após o processo filho ser criado.
; O usuário e o grupo podem ser especificados pelo nome ou por seus IDs numéricos.
; Nota: Se o usuário for root, o executável precisa ser iniciado com
; --allow-to-run-as-root opção para funcionar.
; Valores Padrão: O usuário é definido como usuário do processo mestre por padrão.
; Se o grupo não for definido, o grupo do usuário é usado.
user = nginx
group = nginx
...
Encontre as linhas listen.owner = www-data e listen.group = www-data no arquivo e altere-as para nginx.
; Defina permissões para o socket unix, se um for usado. No Linux, leitura/gravação
; permissões devem ser definidas para permitir conexões de um servidor web. Muitos
; sistemas derivados do BSD permitem conexões independentemente das permissões. O proprietário
; e o grupo podem ser especificados pelo nome ou por seus IDs numéricos.
; Valores Padrão: O proprietário é definido como usuário do processo mestre em execução. Se o grupo
; não for definido, o grupo do proprietário é usado. O modo é definido como 0660.
listen.owner = nginx
listen.group = nginx
Salve o arquivo pressionando Ctrl + X e digitando Y quando solicitado.
Aumente o tamanho máximo de upload de arquivos para 8 MB.
$ sudo sed -i 's/upload_max_filesize = 2M/upload_max_filesize = 8M/' /etc/php/8.2/fpm/php.ini
Reinicie o serviço PHP-FPM.
$ sudo systemctl restart php8.2-fpm
Altere o grupo do diretório de sessões PHP para Nginx.
$ sudo chgrp -R nginx /var/lib/php/sessions
Passo 10 - Configurar o Nginx
Execute o seguinte comando para adicionar um arquivo de configuração para seu site.
$ sudo nano /etc/nginx/conf.d/flarum.conf
Cole o seguinte código no editor.
server {
listen [::]:80;
listen 80;
server_name flarum.example.com;
# redirecionar http para https
return 301 https://flarum.example.com$request_uri;
}
server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
server_name flarum.example.com;
access_log /var/log/nginx/flarum.access.log;
error_log /var/log/nginx/flarum.error.log;
root /var/www/flarum/public;
index index.php;
include /var/www/flarum/.nginx.conf;
client_max_body_size 8M;
if ($host != "flarum.example.com") {
return 301 $scheme://flarum.example.com$request_uri;
}
# Código SSL
ssl_certificate /etc/letsencrypt/live/flarum.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/flarum.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/flarum.example.com/chain.pem;
ssl_session_timeout 1d;
ssl_session_cache shared:MozSSL:10m;
ssl_session_tickets off;
ssl_prefer_server_ciphers off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
resolver 1.1.1.1 1.0.0.1 [2606:4700:4700::1111] [2606:4700:4700::1001] 8.8.8.8 8.8.4.4 [2001:4860:4860::8888] [2001:4860:4860::8844] valid=60s;
resolver_timeout 2s;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
tcp_nopush on;
types_hash_max_size 2048;
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_index index.php;
include fastcgi_params;
}
}
Este arquivo assume que estaremos hospedando example.com no diretório /var/www/flarum/public. O Flarum vem com algumas configurações padrão do Nginx no arquivo /var/www/flarum/.nginx.conf, que incluímos em nossa configuração do Nginx.
Uma vez terminado, pressione Ctrl + X para fechar o editor e pressione Y quando solicitado para salvar o arquivo.
Abra o arquivo /etc/nginx/nginx.conf para edição.
$ sudo nano /etc/nginx/nginx.conf
Adicione a seguinte linha antes da linha include /etc/nginx/conf.d/*.conf;.
server_names_hash_bucket_size 64;
Salve o arquivo pressionando Ctrl + X e digitando Y quando solicitado. Teste a configuração do Nginx.
$ sudo nginx -t
Você deve ver a seguinte saída indicando que sua configuração está correta.
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Recarregue o serviço Nginx.
$ sudo systemctl reload nginx
Passo 11 - Acessar e Completar a Instalação do Flarum
Abra http://example.com em seu navegador para completar a instalação.
Preencha os valores de banco de dados necessários que criamos acima. Você pode deixar a entrada Prefixo da Tabela em branco para permitir que o Flarum use o prefixo padrão ou pode inserir qualquer prefixo personalizado como fla_. Escolha um nome de usuário, uma senha forte e um ID de e-mail para instalar o Flarum.
Clique no botão Instalar Flarum para finalizar a instalação.
Uma vez instalado, você deve ser recebido pela página inicial padrão do Flarum.
Seu fórum agora está instalado e pronto para uso.
Habilitar 2FA
A autenticação de dois fatores é um recurso essencial para qualquer fórum público. O Flarum não vem com o recurso nativamente, mas você pode habilitá-lo instalando uma extensão para isso. A extensão está disponível via Extiverse. Extiverse é um repositório não oficial de temas e plugins do Flarum.
Para instalar o plugin, primeiro, mude para o diretório do Flarum.
$ cd /var/www/flarum
Instale o plugin usando o Composer.
$ composer require ianm/twofactor:"*"
O próximo passo é habilitar o plugin a partir do painel de administração do Flarum. Clique no seu nome no canto superior direito da página inicial e clique no link Administração no menu suspenso.
Você será levado ao painel de administração. Selecione o recurso 2FA no menu à esquerda e ative-o. Você não precisa alterar nada, pois as configurações padrão devem funcionar bem.
Se você deseja que os moderadores do fórum tenham 2FA habilitado, clique no botão Mods e ative a configuração 2FA obrigatória. Clique no botão Salvar Alterações para finalizar.
Para habilitar 2FA para sua conta, abra sua página de configurações no menu do canto superior direito da página inicial do fórum. Abra a página Segurança selecionando no menu lateral esquerdo.
Clique no botão Habilitar 2FA e a seguinte janela pop-up será aberta.
Escaneie o código QR ou escolha a opção manual usando seu aplicativo 2FA e insira o código gerado na caixa. Clique no botão Verificar quando terminar. Você verá códigos de backup. Salve-os e clique no botão para prosseguir.
Você será solicitado a confirmação novamente. Clique no botão Ok para prosseguir. O processo agora está completo.
Configurar Configurações de E-mail
Você também precisará configurar as configurações de e-mail a partir do painel de administração. O Flarum suporta nativamente o serviço SMTP do Mailgun ou você pode usar um provedor SMTP externo.
Estamos usando o serviço Amazon SES, para o qual selecionamos smtp no menu suspenso do driver de e-mail na página de e-mail. Clique no botão Salvar Alterações e depois clique no botão Enviar para enviar um e-mail de teste. A página notificará se o e-mail foi enviado com sucesso. Você deve receber o seguinte e-mail.
Se você deseja usar o Mailgun, escolha mailgun no menu suspenso. Preencha os campos necessários e salve as configurações.
Antes de enviar um e-mail de teste, você deve instalar um pacote do composer para que funcione. Mude para o diretório do Flarum no servidor.
$ cd /var/www/flarum
Instale o pacote do composer.
$ composer require guzzlehttp/guzzle:^7.0
Envie um e-mail de teste para verificar.
Conclusão
Isso conclui nosso tutorial sobre como instalar o software de fórum Flarum Community em um servidor Debian 12. Se você tiver alguma dúvida ou feedback, deixe-os nos comentários abaixo.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.