Como Instalar MediaWiki no Ubuntu 24.04

MediaWiki é um software wiki de código aberto escrito em PHP e MySQL. É um software wiki escalável e extensível que alimenta sites como Wikipedia e Wikimedia. MediaWiki pode ser usado como uma plataforma de colaboração e documentação. Ele permite que você organize a documentação e a torne pública para todos. Suporta múltiplos idiomas e oferece personalização para diferentes aspectos, desde temas/skins, plugins e editores.

Este guia mostrará como instalar o software MediaWiki no servidor Ubuntu 24.04. Você instalará o MediaWiki com o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP), e depois o protegerá com HTTPS através do Certbot e Letsencrypt.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontado para um endereço IP do servidor.

Instalando Dependências

Para instalar o MediaWiki, você deve garantir que as dependências estejam instaladas em seu sistema. Atualmente, a versão estável do MediaWiki 1.41 requer PHP 8.1-83. Nesta seção, você instalará o Apache, o servidor MariaDB, PHP 8.3 e ImageMagick como dependências para o MediaWiki.

Primeiramente, execute o seguinte comando para atualizar seu repositório Ubuntu.

sudo apt update

Agora, instale as dependências para o MediaWiki usando o seguinte comando. Digite Y para confirmar o processo. Com isso, você instalará o LAMP Stack (Apache, MySQL/MariaDB e PHP) e os pacotes do ImageMagick.

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php php php-common php-intl php-xml php-curl php-gd php-mbstring php-mysql php-apcu

Após a instalação ser concluída, verifique o status do serviço apache2 com o comando abaixo. Você verá que o servidor web Apache está em execução e habilitado.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Verifique o serviço mariadb com o seguinte comando. Você pode ver a seguir que o servidor MariaDB está em execução e habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Por fim, verifique a versão do PHP usando o seguinte comando. Você verá o PHP 8.3 instalado em seu sistema.

sudo php -v

Configurando UFW

Adicione e habilite o perfil Apache Full no UFW com o seguinte:

sudo ufw allow "Apache Full"

Agora verifique as regras habilitadas no UFW com o comando ufw status abaixo. O perfil Apache Full abre portas para os protocolos HTTP e HTTPS.

sudo ufw status

Configurando PHP

Depois de instalar as dependências, você configurará o PHP editando o arquivo de configuração padrão /etc/php/8.3/apache2/php.ini.

Execute o seguinte comando nano para abrir o arquivo de configuração do PHP /etc/php/8.3/apache2/php.ini.

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

Descomente e altere a configuração padrão do PHP com o seguinte. Certifique-se de ajustar tanto as opções memory_limit quanto date.timezone conforme necessário.

date.timezone = Europe/Amsterdam  
upload_max_filesize = 80M  
memory_limit = 512M  
max_execution_time = 360

Salve e saia do arquivo quando terminar.

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

sudo systemctl restart apache2

Configurando o servidor MariaDB

Agora que o PHP está configurado, você protegerá o servidor MariaDB e criará um novo banco de dados e usuário para o MediaWiki. Você protegerá o MariaDB com a utilidade mariadb-secure-installation, e depois criará um novo banco de dados e usuário através do cliente mariadb.

Proteja sua instalação do servidor MariaDB com o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Agora você será solicitado a configurar o seguinte para o servidor MariaDB:

• 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 do seu MariaDB.
• Por fim, digite Y para recarregar os privilégios das tabelas e aplicar as novas alterações.

Após o MariaDB ser protegido, faça login no servidor MariaDB com o seguinte - Digite sua senha root quando solicitado.

sudo mariadb -u root -p

Em seguida, execute as seguintes consultas para criar um novo banco de dados e usuário para o MediaWiki. Neste exemplo, você criará um novo banco de dados mediawikidb, um usuário mediawiki com a senha mediawikipassdb. Você pode ajustar os detalhes do banco de dados com suas informações.

CREATE DATABASE mediawikidb;  
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';  
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Agora execute a consulta abaixo para verificar os privilégios do usuário mediawiki. Abaixo você pode ver que o usuário mediawiki pode acessar o banco de dados mediawikidb.

SHOW GRANTS FOR mediawiki@localhost;

Por fim, digite quit para sair do servidor MariaDB.

Baixando o MediaWiki

Nesta seção, você fará o download do código-fonte do MediaWiki 1.41 e configurará o diretório de instalação para o MediaWiki.

Vá para o diretório /var/www e baixe o código-fonte do MediaWiki com o comando curl abaixo. Certifique-se de visitar a página de download do MediaWiki para obter a versão mais recente.

cd /var/www/  
curl -O https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.1.tar.gz

Após o download, extraia o código-fonte do MediaWiki e renomeie o diretório para mediawiki. Com isso, seu diretório raiz de documentos para o MediaWiki deve estar disponível no diretório /var/www/mediawiki.

tar -xvzf mediawiki-*.tar.gz  
mv mediawiki-* /mediawiki/

Agora, mude a propriedade do diretório /var/www/mediawiki para o usuário www-data e a permissão padrão para 0755.

sudo chown -R www-data:www-data /var/www/mediawiki  
sudo chmod 755 /var/www/mediawiki

Configurando o host virtual do Apache

Agora que você baixou o código-fonte do MediaWiki, o próximo passo será criar um novo arquivo de host virtual do Apache para executar o MediaWiki. Certifique-se de que você tenha um nome de domínio apontado para seu servidor MediaWiki.

Primeiro, execute o seguinte comando para habilitar o módulo rewrite no servidor web Apache.

sudo a2enmod rewrite

Agora crie um novo arquivo de host virtual /etc/apache2/sites-available/mediawiki.conf com o seguinte comando do editor nano.

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

Digite a seguinte configuração e certifique-se de alterar a opção ServerName com seu nome de domínio.

  
  
 ServerName wiki.howtoforge.local  
  
 ServerAdmin [email protected]  
 DocumentRoot /var/www/mediawiki  
  
 ErrorLog /var/log/apache2/wiki.howtoforge.local_error.log  
 CustomLog /var/log/apache2/wiki.howtoforge.local_access.log combined  
  
   
 Options FollowSymlinks  
 AllowOverride All  
 Require all granted  
   
  

Salve e feche o arquivo quando terminar.

Em seguida, execute o comando abaixo para ativar o arquivo de host virtual mediawiki.conf e verificar sua sintaxe do Apache. Se você tiver uma sintaxe correta do Apache, receberá uma saída Syntax is OK.

sudo a2ensite mediawiki.conf  
sudo apachectl configtest

Por fim, execute o comando abaixo para reiniciar o Apache e aplicar suas alterações. Com isso, sua instalação do MediaWiki deve estar pronta.

sudo systemctl restart apache2

Protegendo o MediaWiki com HTTPS

Neste guia, você protegerá o MediaWiki com HTTPS. Se você estiver usando um domínio público, pode usar certificados SSL gratuitos do Letsencrypt e configurar HTTPS automaticamente. Você pode gerar certificados SSL e configurar HTTPS manualmente para usuários de domínio local.

Instale os pacotes certbot e python3-certbot-apache com o seguinte comando. Digite Y para confirmar a instalação.

sudo apt install certbot python3-certbot-apache

Após a instalação ser concluída, execute o comando certbot abaixo para gerar certificados SSL/TLS para sua instalação do MediaWiki. Certifique-se de alterar o endereço de e-mail e o nome de domínio com suas informações.

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

Você verá os certificados SSL/TLS no diretório /etc/letsencrypt/live/domain.com. Sua instalação do MediaWiki deve estar automaticamente protegida com HTTPS.

Instalando o MediaWiki

Abra seu navegador web e visite seu nome de domínio do MediaWiki, como http://wiki.howtoforge.local. Clique no link Configurar o wiki para iniciar a instalação.

Selecione seu idioma para o MediaWiki e clique em Continuar.

Clique em Continuar para aceitar os termos do MediaWiki.

Digite os detalhes do seu banco de dados MariaDB e clique em Continuar.

Para as configurações do banco de dados, deixe isso como padrão e clique em Continuar.

Agora digite o título do seu wiki e crie um novo usuário administrador e senha para sua instalação do MediaWiki. Em seguida, clique em Continuar novamente.

Nas opções adicionais do MediaWiki, vá para a seção Skins e selecione seu tema/skin padrão. Neste exemplo, usaremos MinervaNeue.

Role para baixo, deixe outras configurações (ou altere-as conforme necessário), e clique em Continuar.

Clique em Continuar para confirmar a instalação.

Após a instalação ser concluída, clique em Continuar novamente.

Agora o arquivo LocalSettings.php será baixado automaticamente para sua máquina local. Faça o upload desse arquivo ou crie o arquivo LocalSettings.php com o mesmo conteúdo que você tem.

No arquivo LocalSettings.php, altere a opção padrão $wgDefaultSkin para minerva.

$wgDefaultSkin = "minerva";

Agora visite a página inicial do seu MediaWiki e você pode ver abaixo a página inicial do tema MinervaNeue.

Você pode agora clicar no botão de login no canto superior direito, e depois digitar seu usuário e senha de administrador.

Conclusão

Parabéns! Você completou a instalação do MediaWiki no servidor Ubuntu 24.04. Você tem o MediaWiki em execução com o LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e protegido com HTTPS através do certbot e Letsencrypt.