Manual:Requisitos para instalação

Além do próprio software MediaWiki, você precisa:

• Um servidor web para publicar as páginas da MediaWiki para o navegador.

• PHP para executar o MediaWiki.

• Um servidor de banco de dados para armazenar as páginas e dados do MediaWiki.

Além disso, há várias dependências opcionais que são exigidas se você quiser utilizar certos recursos avançados (veja abaixo).

Se seu website é hospedado por terceiros (isto é, se você não tem controle direto sobre ele), entre em contato com o administrador do servidor ou com a companhia de hospedagem para certificar-se de que estes pacotes de software estão instalados e disponíveis.

Para executar os scripts de manutenção Mediawiki, irá precisar de acesso à linha de comandos.

Instalação de download único

Se você estiver usando o Linux, é melhor instalar o servidor web Apache, PHP e o servidor de banco de dados MariaDB usando seu gerenciador de pacotes. Usando Debian e Ubuntu, faça o seguinte:

sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-apcu php-curl php-mysql php-xml

Pacotes de software

Em outros sistemas operacionais, use um pacote de software como o XAMPP do https://www.apachefriends.org para instalar e configurar todos os pacotes importantes – servidor web Apache, PHP, e MariaDB – com apenas um download. Ele está disponível para Linux, Windows, Mac e Solaris. Em maio de 2025, a última versão do XAMPP incluía o PHP 8.2 (o MediaWiki requer pelo menos o 8.1.0).

Alternativamente, se você tem um computador Apple, você pode usar MAMP, que é o equivalente a XAMPP. O MAMP atualmente inclui a capacidade de executar o servidor web Apache e um banco de dados MySQL. Ele está disponível para Windows e Mac, mas é geralmente usado no Mac em vez do Windows.

Servidor web

Para gerar as páginas que serão mostradas no seu navegador, o MediaWiki exige algum software de servidor web. Frequentemente você não terá a escolha de qual software usar – será aquele fornecido pelo seu provedor de hospedagem..

O MediaWiki é amplamente compatível com todos os principais servidores web que podem invocar uma versão PHP compatível. A maioria das instalações usa o servidor web Apache HTTPD. ([$exemplo de configuração de url]) Nginx também é uma boa escolha.

PHP

PHP é a linguagem de programação na qual o MediaWiki foi escrito, e o componente PHP é exigido para o software funcionar.

• Para a última versão estável do MediaWiki, é necessário pelo menos PHP 8.1.0. Consulte a página em Compatibilidade para mais informações.

• As seguintes extensões do PHP são necessárias (elas são geralmente compilados como parte do PHP em si): calendar, dom, fileinfo, json, openssl, xml, xmlreader.
• As seguintes extensões do PHP também são {{$1|requisitadas}}.

Check the output of php -m to find out which extensions are currently enabled in your particular case.

• The following PHP core extensions are also required:

• • intl - Exigido desde da versão MW 1.36
  • mbstring - Exigido desde da versão MW 1.27
  • bcmath or gmp - required on 32-bit systems

As extensões a seguir são recomendadas além das obrigatórias.

• • apcu
  • curl

MediaWiki necessita apenas extensões que são habilitadas no PHP por padrão.

Se o seu provedor de hospedagem fornecer um ambiente LAMP básico sem eles, você pode precisar instalar ou habilitar eles manualmente.

• • No Debian/Ubuntu, o comandos a seguir instalam todas as extensões recomendadas listadas acima:

    sudo apt-get install php php-intl php-mbstring php-apcu php-curl

    .
• Nos servidores de hospedagem com painel de controle, como o cPanel, você geralmente pode usar "Selecionar Versão PHP" (Seletor PHP) para habilitar essas extensões. (Por exemplo, após você ver "Está faltando um extensão PHP que o MediaWiki necessita para ser executado. Por favor, instale: intl", ou em inglês: "You are missing a required extension to PHP that MediaWiki requires to run. Please install: intl")

• Na maioria das distros baseadas no Debian/Ubuntu, o pacote php-mysql é necessário se você quiser que o MediaWiki use o MySQL.

• Algumas funcionalidade do MediaWiki podem exigir funções PHP que executam processos externos, como a miniaturização de imagens, que alguns provedores de hospedagem baratos normalmente desativam. Por favor, leve isso em consideração se você pretende instalar o MediaWiki em um servidor compartilhado..

• Extensões MediaWiki podem exigir recursos adicionais PHP, por exemplo, o VisualEditor requer suporte libcurl (php-curl em distros baseadas no Debian/Ubuntu).

Se você precisar compilar o PHP do código-fonte, então veja a seção Configuração do PHP para opções de compilação que afetam o MediaWiki.

Servidor de banco de dados

O MediaWiki guarda todos os textos e dados (artigos, informações sobre o usuário, mensagens do sistema, etc.) num banco de dados, que pode ser compartilhado com outras aplicações web (phpBB, etc.). Você precisará de um dos servidores de banco de dados para rodar a versão mais atual do MediaWiki:

• MariaDB 10.3.0+ ou MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.24.0+

A utilização de MariaDB ou MySQL é recomendado, porque a Wikimedia utiliza MariaDB. Quaisquer outros servidores de banco de dados são menos testados, e provavelmente você irá encontrar alguns erros.

Desde o 1.34 , não oferecemos mais suporte ao uso do Oracle e do Microsoft SQL Server .

Alguns usuários consideram útil a instalação pacotes adicionais de software painel de controle, tais como o phpMyAdmin (MySQL/MariaDB) ou o phpPgAdmin (PostgreSQL) para ajudar a administrar o servidor de banco de dados. Alguns Serviços de hospedagem também disponibilizam esse software.

Requisitos de hardware

Os requisitos mínimos recomendados são 256MB de RAM e 85MB de armazenamento para um site hospedado em um único computador, embora isso não seja suficiente para um site público movimentado ou que permita upload de arquivos. Alguns usuários informaram ter executado o MediaWiki em computadores com uma quantidade tão pequena quanto 48MB de RAM.

Dependências opcionais

• ImageMagick ou GD são exigidos para a miniaturização de imagens.

• Acesso Shell é necessário para executar Scripts de manutenção ; atualizar o MediaWiki, pode ser mais difícil sem ele.
• Enviar notificações de e-mail através do servidor pode precisar de Agente de transporte de correio eletrônico.

• GNU diff3 pode ser usado para resolver conflitos automaticamente.

• memcached pode ser utilizado para o caching de objeto.

Ver também

• Compatibilidade , para obter informações sobre como os requisitos de instalação da Mediawiki provavelmente mudarão no futuro

• Manual:Ajuda específica do sistema operacional